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EXPRESS MAIL LABEL NO: 
EL579665856US 



METHOD AND SYSTEM FOR REMOTE CONTROL AND INTERACTION 



BACKGROUND OF THE INVENTION 

Field of the Invention 

The present invention relates to runtime 
environment component services, and in particular to a 
runtime environment component services provided by a 
first computer system to a second computer system over a 
communication network. 

Description of Related Art 

Today, many computer networks are arranged as 
client-server systems. In a client-server system, a 
potentially large number of smaller computer systems, 
like laptops or handhold organizers, called clients, 
are, temporarily or permanently connected to a larger 
computer system, called server. The connection between 
the clients and the server may be effected, for example, 
via the Internet . 

In client-server systems, a client typically has 
limited storage and processing capabilities. 
Nevertheless, many software programs are executed on the 
clients. One prior art way to make a software program 
on the server available to clients was to use a browser 
on the client . The browser was used to transfer a 
relatively large software program or a relatively large 
part thereof from the server to a client so that the 
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software program could be executed locally on the 
client. This method required that the software program 
or a part thereof be stored and processed on the client. 

For this purpose, the client must have sufficient 
storage capacity and processing capability to execute 
the software program locally. These requirements may 
conflict with the aim of having smaller and smaller 
clients, including cellular telephones, which may not 
have enough storage capacity or processing capability 
for storing or processing, respectively, large software 
programs or large parts of software programs. 

Frequently, a software program requested by a 
client for execution is transferred every time the 
software program is executed. The speed of this 
download depends on the available data transfer capacity 
of the network connecting the server and the client. 
Here, frequently the available bandwidth of the network 
connection is decisive. In many instances the described 
client-server systems would be undesirably slow in 
executing a software program, because the download takes 
too much time. 

Therefore, software programs, which are called 
frequently for execution on a client, may be 
permanently, or at least for some time, stored on the 
client. This leads, however, to the task of regularly, 
and maybe even individually, updating a potentially 
large number of clients, if relevant software programs 
are amended or updated. Considerable administration 
efforts for client -server systems may be the 
consequence . 

It is also known to include into a software program 
executed on a client procedures, which are executed on a 
server. A prior technique to implement this used CORBA. 
For example, certain more complicated calculations, the 
result of which may be needed on a client, were carried 
out on a server connected with the client over a 
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network. However, this required that the program 
developer include particular commands into the code of 
the software program to be executed on the client for 
calling the software program to be executed on the 
5 server, in the given example the calculation program. 
This was not only cumbersome, but also led to 
incompatibilities when the software program to be 
executed on the server was amended. 

It is further known to allow a user to initiate 

10 execution of a program server from a client and to 
review the results of the program execution on the 
client. This approach is used in the UNIX X-Windows 
system. However, this approach did not permit the 
client to control the program and did not permit 

15 integration of server side functionality into the client 
side environment at the level of function calls. 

SUMMARY OF THE INVENTION 

According to one embodiment of the present 
2 0 invention, a user device, a first computer system, 
includes a lightweight component that receives user 
input actions for a runtime environment component that 
is executing on a second computer system. The 
lightweight component sends a remote input action 

2 5 command to a user interface infrastructure that is 

executing on the second computer system. 

In response to the remote input action command, the 
user interface infrastructure sends a local input action 
command to the runtime environment component that 

3 0 processes the command, and issues a local output command 

to the user interface infrastructure that in turn sends 
a remote output command to the lightweight component on 
the user device. In response to the remote output 
command, the lightweight component causes an output on 
35 the user device. This output could be redrawing a 
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display, playing a sound, or perhaps routing information 
to a local printer. 

All the management of components in the user 
interface, management of data and so on is performed on 
the second computer system and so the lightweight 
component only has, for example, to update the display 
to reflect the state of the runtime environment 
component as indicated by the remote output command 
received. It appears to the user that the runtime 
environment component is executing locally on the user 
device despite that fact that the user device is only 
functioning as an input /output device for the runtime 
environment component . 

In one embodiment, a method for presenting a 
runtime environment component service by a first 
computer system to a second computer system over a 
communication network is performed by the first computer 
system. The method includes generating a user interface 
infrastructure on the first computer system. The user 
interface infrastructure receives graphic user interface 
events from the second computer system and sends remote 
graphic user interface commands to the second computer 
system. The user interface infrastructure is used to 
initialize the runtime environment component service. 
The runtime environment component service sends graphic 
user interface commands to the user interface 
infrastructure . 

In another embodiment, the first computer system 
receives a remote input action command for a runtime 
environment component service via a communication 
network. The remote input action is being generated in 
the second computer system by a lightweight component 
corresponding to the runtime environment component 
service. A local input action command is transmitted to 
the runtime environment component service in response to 
the remote input action command. The local input action 



command is processed by the runtime environment 
component service, and a local output command is 
generated by the runtime environment component service 
for a graphical user interface. A remote output command 
is transmitted to the lightweight component in response 
to the local output command. 

In yet another embodiment, a method for enabling a 
user device to run a runtime environment component on 
another computer includes running a browser on the user 
device. A lightweight component is run within the 
browser. The lightweight component receives user input 
actions on the user device and generates corresponding 
user interface events to the another computer for 
processing by the runtime environment component. 

A computer program product, in one embodiment, 
comprises computer code including a remote frame window 
class that in turn includes a remote output device 
interface and a remote frame window interface. The 
computer code optionally includes any or all of a bean 
frame class comprising a frame interface; a bean window 
class including an event handler interface and a window 
peer interface; and an abstract windowing toolkit. 

BRIEF DESCRIPTION OF THE DRAWINGS 

Fig. 1 is an illustration of one embodiment of the 
present invention with a plurality of user devices that 
each can execute a lightweight component that 
corresponds to at least one component on the server 
computer system. 

Fig. 2 is a more detailed illustration of one 
embodiment of the present invention with a 
representative user device that executes a lightweight 
component that corresponds to at least one component on 
the server computer system. 

Fig. 3 is a process flow diagram for one embodiment 
of the present invention. 
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Fig. 4 is an architecture diagram for one 
embodiment of the present invention. 

Figs . 5A to 5D are a sequence diagram for a JAVA- 
based implementation of one embodiment of the present 
5 invention. 

Fig. 6 is a class diagram for the embodiment of the 
present invention illustrated in Figs. 5A to 5D. 

Fig. 7 is a cross-reference between Tables in the 
description and selected interfaces in Fig. 6. 
10 Figs. 8A to 8C are a cross-reference between Tables 

in the description and selected interfaces in Fig. 6. 

Fig. 9 is a cross-reference between Tables in the 
description and selected interfaces in Fig. 6. 

Figs. 10A and 10B are a cross-reference between 
15 Tables in the description and selected interfaces in 
Fig. 6. 

In the drawings and the following detailed 
description, elements with the same reference numeral 
are the same element. Also, the first digit of a 
2 0 reference numeral for an element indicates the first 
drawing in which that element appeared. A word in 
italics and the same word not in italics represent the 
same element. The italics are used only for convenience 
and not to denote different embodiments or elements. 

25 

DETAILED DESCRIPTION 

According to one embodiment of the present 
invention, a user can access and use applications or 
services, e.g., application 112 in a suite of 

30 applications 12 0, on server computer system 100 from 

almost any available device, e.g., any one of a portable 
computer 102A, a mobile telephone 102B, a 
workstation 102C, a home personal computer (PC) 102D, a 
personal digital assistant 102E, or an Internet cafe 

35 machine 102F. No longer is a user limited to using 

-6- 



Asf iled 
P459S 



either workstations and/or portable computers with suite 
of applications 120 installed thereon. 

For example, a user on a vacation overseas suddenly 
realizes that the presentation her boss is going to 
5 deliver the next morning contains a critical error. The 
user drops by an Internet cafe and from any machine 102F 
at the cafe accesses the presentation via server 
computer system 10 0, and makes the necessary corrections 
using applications written, for example, in a visual 
10 basic programming language and/or the C++ programming 
language even though only a browser is available on 
machine 102F. 

In another scenario, the user is having dinner at a 
friend's house, and gets an urgent call saying that a 

15 report that can be assessed via server computer 

system 100 must be revised that evening. The revisions 
will not require much work, but the trip to the office 
and back is a very unwelcome prospect. Using the 
friend's PC 102D and the friend's Internet service 

20 provider, the user works on the report without leaving 
his friend's home even though no software for accessing 
application suite 120 is available on PC 102D. The user 
interface on PC 102D and the application capability is 
that same as if the user were executing the application 

25 at the office. 

Another user is expecting an important document, 
but the user has a business appointment outside the 
office. The document arrives by e-mail while the user 
is in transit. Using a PDA 102E while on the train, the 

3 0 user accesses the e-mail using server computer 100, 

reviews the document, and then re-directs the document 
to the fax machine at the site to which the user is 
going . 

A customer would like to meet with a user tomorrow. 
3 5 The user thinks he will be available, but the user 

doesn't know whether anyone scheduled the time while the 
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user was away from the office, and now the office is 
closed. Using a mobile telephone 102B, the user 
accesses his up-to-the-minute calendar via server 
computer system 100 and schedules the appointment. 

Hence, in one embodiment, using a web browser and 
an Internet connection, the user simply logs on to a web 
server 111, and proceeds as though everything were 
locally resident on his/her machine. While execution 
actually takes place on server computer system 100, this 
fact is transparent to the user. Similarly, local 
services available on a client system, including devices 
like printers and local storage, can be utilized in a 
transparent manner. 

In addition to using browsers, users can access 
applications on server computer system 10 0, sometimes 
called server 100, from Wireless Application Protocol 
(WAP) devices, which include mobile phone 102B and 
perhaps PDA 102E. Because of the limited capabilities 
of devices 102B and 102E, functionality is not as 
extensive as from a system that can run a full browser. 
Accordingly, in one embodiment, users are able to view 
their mail and data, but users don't have full editing 
capabilities in this embodiment. However, users can use 
mobile phones and PDAs to manage their data and the 
users can direct the movement of information to other 
devices . 

Hence, a user of any one user device 102i, where i 
is A to G, of a plurality of devices 102A to 102G can 
use an application 112, or any other application in 
suite 120 that can include for example a word processing 
application, a spreadsheet application, a database 
application, a graphics and drawing application, an e- 
mail application, a contacts manager application, a 
schedule application, and a presentation application, as 
if that application were executing locally on user 
device 102i. One office application package suitable 
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for use with this invention, is the STAROFF I CE 
Application Suite available from Sun Microsystems, 901 
San Antonio Road, Palo Alto, CA. (STAROFFICE is a 
trademark of Sun Microsystems, Inc.) The user has 
5 access to the functionality of application 112 even in 
situations where user device 102i has neither the memory 
capacity nor the processing power to execute 
application 112. 

As explained more completely below, in each of the 
10 above examples, a lightweight component 230 (Fig. 2) is 
either stored locally in a memory of user device 102 i, 
or is downloaded from server computer system 100 (Fig. 2) 
to memory 211 in user device 102i. Lightweight 
Z, component 230, in the embodiment, is loaded in a 

15 browser, to communicate over a network, e.g., enterprise 
,=1 network 103, Internet 106, or a combination of the 

^ two 103/106, with application 112 that is executing on 

JO server computer system 100. 

^ Lightweight component 230, as explained more 

2 0 completely below, is not a prior art software program. 
M< Rather lightweight component 23 0, in one embodiment, 

maps visual display instructions from application 112 
Q executing on server computer system 100 to a platform 

!p * dependent graphic layer that in turn generates a user 

25 interface on display screen 295 of monitor 216. The 
user interface for application 112 is similar to the 
user interface that the user would see if 
application 112 were executing locally on device 102i. 
The interfaces may not be identical if user device 102i 
30 has limited input/output capability, e.g., user 
device 102i is a mobile telephone. 

When lightweight component 230 receives an input 
event from the windowing environment executing on user 
device, e.g., the JAVA Abstract Windowing Toolkit (AWT), 
35 lightweight component 230 transmits the event to 

application 112 for processing. Here, the input event 
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could be selection of a menu item, configuration of a 
menu, a keyboard input, a mouse input, or any other 
input event supported by application 112 . 

Application 112, executing on server computer 
5 system 100 processes the event received from lightweight 
component 23 0 and performs any operations required on 
server computer system 100. Output instructions from 
application 112 are directed to lightweight 
component 230 on user device 102i. 

10 When lightweight component 23 0 receives the output 

instructions, lightweight component 230 executes the 
instructions. For example, if the instructions are to 
update the display, lightweight component 23 0 maps the 
instruction to a platform dependent graphic layer that 

15 in turn redraws the display. All the management of 

components in the user interface, management of data and 
so on is performed on server computer system 100 and so 
lightweight component 23 0 only has to update the display 
to reflect the state of application 112 as indicated by 

20 the output instructions received from application 112. 
Consequently, it appears to the user that 
application 112 is executing locally on user device 102i 
despite that fact that user device 102 i is only 
functioning as an input /output device for 

25 application 112. Lightweight component 230 on user 
device 102i routes the output to an output device of 
device 102i, e.g., a display unit 216 or a locally 
connected printer 217. 

As used herein a lightweight component 230, 

3 0 sometimes called a thin client, is software, which, upon 
execution, is able to provide input to and receive 
output from a runtime environment component, e.g., an 
application or service 112 that is sometime called a 
runtime environment component 112. Lightweight 

3 5 component 23 0 is tiny enough to be downloaded from first 
computer system 100 onto second computer system 102i via 
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a network 103 and 106 within a time significantly 
smaller than the time required to download the whole 
runtime environment component 112. 

In one embodiment, the download time t is 
particularly, but not necessarily, defined as 

t < (8 N / C B ) + t x , 

where N is the size of runtime environment component 112 
in bytes, C B is the average bandwidth in bits per second 
of the network connection between first computer 
system 100 and second computer system 102i, and t x is the 
time needed to initialize runtime environment 
component 112 in its respective local environment on 
first computer system 100. In today's commonly 
available network connections between servers and 
clients, time t is typically be about ten seconds. 

When using networks commonly used at present for 
the connection of clients and servers, this time 
condition gives a lightweight component 230, which is - 
measured in necessary storage space - less than ten or 
even less than five percent of the scope of the totality 
of the runtime environment components 12 0, which can be 
requested by lightweight component 23 0, including any 
auxiliary software programs which these runtime 
environment components need to be executed in first 
computer system 100 . 

Correspondence of lightweight component 230 with 
runtime environment component 112 means, in this 
context, that lightweight component 23 0 must offer the 
second computer system 102 i access to the runtime 
environment component service made available by 
component 112. If a plurality of runtime environment 
component services 120 is made available by the 
lightweight component 23 0, which will frequently be the 
case, lightweight component 23 0, in this embodiment, 
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corresponds to this plurality of runtime environment 
component services in the explained sense. 

Hence, in this embodiment, the software system 
includes two parts, a first part 230 executed on a 
5 client device 102i, and a second part 120 residing and 
executed on server computer system 100. Second part 120 
on server 100 makes up the runtime environment, which, 
in this embodiment, comprises a plurality of runtime 
environment components, which are able to provide 

10 services. Furthermore, second part 120 on server 

computer system 100 provides the necessary communication 
tools in order to communicate with client device 102i, 
sometimes called user device 102i. 

The other part 23 0, being executed on client 

15 device 102i, performs communication between client 
device 102 i in requesting a runtime environment 
component service being executed on server 100. The 
server's part of the software system is by far larger in 
size than the client's part thereof. This latter part 

20 is referred to as lightweight component 230. A typical 
size of the software system's part 120 on server 
computer system 100 may be 50 to 100 Megabyte, e.g., an 
office software package, whereas lightweight 
component 230 on client device 102i has a typical size 

25 of 400 Kilobyte, and uses minimal system resources (CPU 
power, memory) . 

Lightweight component 23 0 provides an application- 
programming interface (API) for any application program 
the implementation of which on client device 102i is 

30 allowed by an implementation framework on server 

computer system 100. Various types of lightweight 
components 230 are possible. In one embodiment, the 
lightweight component accesses a particular 
functionality, e.g., a mathematical calculator on 

35 server 100, which provides a specific result to user 
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device 102i for use. In another embodiment, lightweight 
component 23 0 handles visual functionality. 

Hence, in more general terms, runtime environment 
component services are presented by a first computer 
5 system 100 to a second computer system 102i over a 

communication network 103/106. Upon receiving a request 
for a runtime environment component service transmitted 
by second computer system 102i over communication 
network 103/106, first computer system 100 executes a 

10 runtime environment component 112 for producing a result 
according to the received request, and transmits, over 
network 103/106, a response comprising the result to the 
second computer system 102i. 

Herein, computer software programs and parts 

15 thereof, which are called during execution of a 

lightweight component 230, are herein referred to as 
runtime environment components 120. The functionality 
provided by runtime environment components 120 to 
lightweight component 23 0 are herein referred to as 

20 runtime environment component services. The size of 
runtime environment components 12 0 renders a 
distribution over Internet 106 difficult. Runtime 
environment components 12 0 may be implemented in any 
suitable form. Runtime environment components 12 0 may 

2 5 consist of compiled software program code to be executed 

or of script code in any programming language to be 
interpreted before execution by a compiler. Runtime 
environment components 12 0 are typically stored and 
administrated on server computer system 100. 

3 0 Lightweight component 23 0 makes runtime environment 

component services, that means the functionalities 
provided by runtime environment components 12 0, 
available for use without integrating components 12 0 
into lightweight component 230 and without distributing 
3 5 components 12 0 together with lightweight component 230 
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to the place of execution of lightweight component 23 0, 
for example, client device 102i . 

Further, the full functionality of the runtime 
environment components 12 0 is available for all kinds of 
5 client devices independent of whether the client devices 
are powerful enough to store or to execute a runtime 
environment component 112. Further, the user of a 
client device is not charged with the problem of whether 
a specific runtime environment component 112 is 

10 available on client device 102i. 

The holding, maintaining and administrating runtime 
environment components 120, as well as executing runtime 
environment components 120, is placed on first computer 
system 100. Nevertheless, second computer system 102i 

15 can profit from these runtime environment component 
services as if the corresponding runtime environment 
components 120 were present locally on second computer 
system 102i. Therefore, additional functionality is 
provided even to those computer systems, which are not 

2 0 powerful enough to store and / or execute the full range 

of runtime environment components 120, as for example 
notebooks, handheld computers, organizers and mobile 
telephones . 

Figure 3 is a process flow diagram for one 
25 embodiment of method 300 of this invention. Initially, 
a user of device 102i issues a request to use 
applications 120 over network 103/106 to web server 111. 
The transmission of the request over the network 103/106 
is performed according to a predetermined transmission 

3 0 protocol. In response to the request from user 

device 102i, web server 112 determines in lightweight 
component available check operation 301 whether the 
request was from lightweight component 230. If the 
request was from lightweight component 23 0, processing 
35 transfers to login operation 310 and otherwise to device 
capability check operation 302 
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Device capability check operation 3 02 determines 
whether user device 102i can execute and use lightweight 
component 230, e.g., is there a lightweight 
component 23 0 available for the general type of user 
device 102i, and is the operating system, processor, and 
memory of specific user device 102i sufficient to 
execute and support lightweight component 230. This 
information may be included in the initial request, a 
process on server computer system 100 may communicate 
with user device 102 i to obtain the information, or 
alternatively, the request may include an identifier 
that is used to access a database to determine the 
capabilities of user device 102i. 

If user device 102i is capable of executing and 
supporting lightweight component 230, processing 
transfers to download component operation 3 04 and 
otherwise to return error operation 3 03. Return error 
operation 3 03 sends an appropriate error message to user 
device 102i to inform the user of the incompatibility 
between requested application 112 and user device 102i. 

Download component operation 304 downloads, and 
installs if necessary, lightweight component 23 0 on user 
device 102i. Thus, prior to starting login 
operation 310, lightweight component 230 is available on 
user device 102i. 

In response to the request to access 
applications 12 0, in login operation 310, a connection 
is established over network 103/106 to a daemon 
executing on server 112. The daemon returns a handle to 
a daemon service factory to lightweight component 230. 

Upon receipt of the handle to the daemon service 
factory, lightweight component 23 0 issues a request to 
the service factory to initiate execution of a login 
service on server computer system 100. Upon activation 
of the login service, lightweight component 23 0 
transmits a user identification, a password, and options 
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for runtime environment components 12 0 to the login 
service. The login service on server 100 validates the 
user login in login operation 310 and transfers to 
initialize application operation 320. 
5 Start application operation 322 within 

operation 320 activates a service factory for runtime 
environment components 12 0 on server 100 and returns a 
handle to this service factory to lightweight 
component 230. Operation 322 transfers processing to 

10 create user interface operation 326 within initialize 
application operation 320. 

In create user interface operation 326, lightweight 
component 23 0 issues a request to the runtime 
environment components service factory to start an 

15 infrastructure generation service. In response to the 
request, the service factory, executing on server 
computer system 100, activates the infrastructure 
generation service, and returns a handle to this service 
to lightweight component 230. Processing transfers to 

20 create visual infrastructure operation 327. 

In operation 32 7, lightweight component 23 0 issues 
a request to start the infrastructure generation 
service, and passes a handle to a client factory to the 
service. Lightweight component 23 0 next issues a 

25 request to create a visual infrastructure on server 

computer system 100 for processing the visual portion of 
the user interface . 

In response to the request from lightweight 
component, 230, the infrastructure generation service 

3 0 first issues a request to the client factory on user 
device 102i to create a remote frame window, and then 
this service creates a corresponding server window 
object on server computer system 10 0. The server window 
object queries the remote frame window on user 

35 device 102i to determine the fonts, display parameters, 
etc. on user device 102i. Alternatively, the server 
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window object can obtain identifier information from 
user device 102i and then use this identifier 
information to access a database that includes the 
display capabilities of device 102i. Upon completion of 
5 the queries, operation 327 transfers to create 
environment infrastructure operation 328. 

In operation 328, the infrastructure generation 
service creates a frame object that controls the 
environment of the server window object and creates a 

10 direct connection between the frame object and 

lightweight component 230. Operation 328 transfers to 
run application operation 330. 

In run application operation 330, lightweight 
component 23 0 sends a command to the frame object to 

15 load a particular document in application 112 . In 

response, the frame object initializes application 112 
and loads the document in application 112. 

Application 112 reads the loaded document, and 
generates a display layout that is sent to the server 

2 0 window object. In turn, the server window object sends 
the display layout to the remote frame window in 
lightweight component 230. The remote frame window 
generates commands to a device dependant graphic layer, 
e.g., the JAVA AWT, which in turn generates the user 

25 interface on display screen 295 of monitor 216, in this 
embodiment . 

If user device 102i has limited input/output 
capability, the user may be able to only read the 
document, or perhaps direct the document to a local 

30 output device if application 112 includes such a 

capability, e.g., a capability to write to a local 
printer or to write to a fax printer. If as in 
Figure 2, user device 102i includes multiple 
input/output devices, the user can utilize the full 

35 functionality of application 102i. For example, if the 
user utilizes mouse 218 to scroll down in the document. 
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The scroll action is interpreted by the windowing 
environment on user device 102i and a scroll command is 
set by the windowing environment to the remote window 
frame of lightweight component 230. 
5 The remote window frame, in turn, sends a scroll 

command over network 103/106 to the server window object 
on server 100. The server window object processes the 
event received and generates an application event that 
in turn is processed by application 112 . In this 

10 example, application does a re-layout based on the 

scrolling, and redraws the display in the server window 
object that in turn sends a redraw command to the remote 
frame window on user device 102i. 

In one embodiment, the transmissions over 

15 network 103/106 between lightweight component 230 and 
server 100 are encrypted according to known 
technologies. Further, in another embodiment, digital 
signatures are used to provide certification of the 
request mechanism being established on the client for 

2 0 this runtime environment component services system. 

The size of a lightweight component 230 does not 
increase with the number of accessed runtime environment 
components of the implementation server framework. This 
introduces the ability to offer runtime environment 
25 components, which expose only services designed for a 
special purpose and hide the complexity of the 
implementation framework. 

In one embodiment of the invention, the STAROFFICE 
application suite is utilized as runtime environment 

3 0 components 120 on server computer system. Figure 4 is 

an illustration of a layer architecture of the 
STAROFFICE application suite used in this embodiment. 

System abstraction layer 401 encapsulates all 
system specific APIs and provides a consistent object- 
35 oriented API to access system resources in a platform 
independent manner. All platform dependent 
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implementation is below this layer, or is part of 
optional modules. To reduce the porting effort, the 
functionality provided by system abstraction layer 4 01 
is reduced to a minima set available on every platform. 
5 Also, for some systems, layer 4 01 includes some 
implementations to emulate some functionality or 
behavior. For example on systems where no native multi 
threading is supported, layer 401 can support so called 
"user land" threads . 

10 The operating system layer (OSL) within layer 401 

encapsulates all the operating system specific 
functionality for using and accessing system specific 
resources like files, memory, sockets, pipes, etc. The 
OSL is a very thin layer with an object oriented API. 

15 The runtime library within layer 401 provides all 

semi platform independent functionality. There is an 
implementation for string classes provided. Routines 
for conversion of strings to different character sets 
are implemented. The memory management functionality 

20 resides in this module. 

As a generic container library with layer 4 01, the 
standard template library is used. This library 
supplies implementations for list, queues, stacks, maps, 
etc . 

2 5 The remote visual class library (VCL) is shown as 

bridging infrastructure layer 4 02 and system abstraction 
layer 402. Remote VCL receives all user interface 
events and sends responses to user interface events over 
network to lightweight component 23 0 on another 

3 0 computer, which then displays the actual output as 

described above. Remote VCL encapsulates all access to 
the different underlying GUI systems on different client 
devices. Remote VCL is a high level definition of a 
graphic device defined as a set of interfaces. Remote 
35 VCL is based completely on a component infrastructure. 
This gives remote VCL the ability to map functionality, 
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which a client system is unable to support, to a service 
component on the server side emulating this 
functionality. 

The implementation of remote VCL is platform 
5 independent and includes an object oriented 2D graphics 
API with metafiles, fonts, raster operations and the 
whole widget set use by the STAROFFICE application 
suite. This approach virtually guarantees that all 
widgets have the same behavior independently of the used 

10 GUI system on the different platforms. Also the look & 
feel and the functionality of the widgets are on all 
platforms the same. Remote VCL includes a mapping to the 
interface of the lightweight component that is described 
more completely below. Since this mapping is platform 

15 independent, remote VCL does not access any native 
window system. 

Infrastructure layer 402 is a platform independent 
environment for building application, components and 
services. Layer 4 02 covers many aspects of an object 

2 0 oriented API for a complete object oriented platform 
including a component model, scripting, compound 
documents, etc. 

To make the usage of system resources like files, 
threads, sockets, etc. more convenient the virtual 

2 5 operating system layer encapsulates all the 

functionality of the operating system layer into C++ 
classes. The tools libraries are different small 
libraries building up a set of tool functionality. This 
includes a common implementation for handling date and 

3 0 time related data. There is an implementation for 

structured storages available. Other implementations 
provide a generic registry, typesafe management and 
persistence of property data. 

Universal network objects are a component 
3 5 technology that does not depend on any graphical 

subsystem, but are heavily based on multithreading and 
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network communication capabilities. The system consists 
of several pieces. An IDL-Compiler , which generates out 
of the specified definition of an interface a binary 
representation and the associated C-Header or JAVA 
5 technology files. The binary representation is platform 
and language independent and is at runtime used to 
marshal arguments for remote function calls or to 
generate code on the fly for a specific language to 
access the implementation provided by the interface. 

10 Many parts of the UNO technology are implemented as UNO 
components. This helps to create a very flexible system 
and also the extension of the system at runtime. For 
example, by providing new bridges or communication 
protocols, UNO provides transparent access to components 

15 over the network or locally. For a more complete 

description of bridges, see copending, cofiled, and 
commonly assigned U.S. Patent Application Serial No. 
09/xxx,xxx, entitled "A METHOD AND SYSTEM FOR 
DYNAMICALLY DISPATCHING FUNCTION CALLS FROM A FIRST 

2 0 EXECUTION ENVIRONMENT TO A SECOND EXECUTION 

ENVIRONMENT, " of Markus Meyer (Attorney Docket 
No. 4355), which is incorporated herein by reference in 
its entirety. For the communication over the network, 
HOP can be used. If the components are realized as 

2 5 shared libraries, the components can be loaded into to 

the process memory of the application and every access 
of the component is just like a function call without 
any marshalling of arguments which is required for 
remote function calls. 

3 0 The Universal Content Broker (UCB) allows all upper 

layers to access different kind of structure content 
transparently. The UCB includes a core and several 
Universal Content Providers, which are used to integrate 
different access protocols. One implementation provides 
3 5 content providers for the HTTP protocol, FTP protocol, 
WebDAV protocol and access to the local file system. 
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The UCB not only provides access to the content, 
but also the UCB provides the associated meta 
information to the content. Actually, synchronous and 
asynchronous modes for operations are supported. A more 
5 complete description of the UCB is provided in 

copending, cofiled, and commonly assigned U.S. Patent 
Application Serial No. 09/xxx,xxx, entitled "A NETWORK 
PORTAL SYSTEM AND METHODS" of Matthias Hiitsch, Ralf 
Hofmann and Kai Sommerfeld (Attorney Docket No. 4595), 
10 which is incorporated herein by reference in its 
entirety. 

Framework layer 403 allows the reuse of 
implementations in different applications. Layer 403 
provides the framework or environment for each 

15 application and all shared functionality like common 
dialogs, file access or the configuration management 

The application framework library in layer 403 
provides an environment for all applications. All 
functionality shared by all applications and not 

2 0 provided by any other layer is realized here. For the 
framework every visual application has to provide a 
shell and can provide several views. The library 
provides all basic functionality so only the application 
specific features have to be added. 

25 The application framework library is also 

responsible for content detection and aggregation. The 
template management is provided here and the 
configuration management too. The application framework 
library is in some areas related to the compound 

30 documents, because of the functionality for merging or 
switching menu- and toolbars. Also, the library 
provides the capability for customization of all 
applications . 

The SVX library in layer 403 provides shared 

35 functionality for all applications, which is not related 
to a framework. So part of the library is a complete 
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object oriented drawing layer, which is used by several 
applications for graphic editing and output. Also a 
complete 3D-rendering system is part of the drawing 
functionality. The common dialogs for font selection, 
5 color chooser, etc. are all part of this library. Also 
the whole database connectivity is realized here. 

All applications are part of application layer 404. 
The way these applications interact is based on the 
lower layers. All applications like the word processor 

10 application, spreadsheet application, presentation 

application, charting application, etc. build up this 
layer. All these applications are realized as shared 
libraries, which are loaded by the application framework 
at runtime. The framework provides the environment for 

15 all these applications and also provides the 

functionality for how these applications can interact. 

In one embodiment, the user interface library is 
implemented using native compiled computer code using 
the visual class library (VCL) that encapsulates all 

2 0 access to the GUI system on user device 23 0 by 

application 112 that is executing on server computer 
system 100. In another embodiment, the user interface 
library that includes the VCL functionality is 
implemented in the JAVA programming language. 

2 5 Figures 5A to 5D are a sequence diagram for one 

embodiment the present invention. Along the horizontal 
axis are individual objects, where each object is 
represented as a labeled rectangle. For convenience, 
only the objects needed to explain the operation are 

30 included in each Figure. The vertical axis represents 
the passage of time from top to bottom of the page. 
Horizontal lines represent the passing of messages 
between objects. A dashed line extends down from each 
rectangle, and a rectangle along the dashed line 

35 represents the lifetime of the object. Moreover, 
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brackets are used to show which objects exist on client 
device 102i and which objects exist on server 100. 

In one embodiment, lightweight component 23 0 is 
embedded in a graphical environment that includes a 
5 display software program with a graphical user interface 
(GUI) . The graphical user interface is referred to as a 
panel. An example of one implementation is a Java bean, 
which is embedded in an HTML page and rendered by a 
browser. This Java bean represents a view (in a window) 

10 of an office application component (e.g. STAROFFICE 
Writer) or another visual office component. In this 
environment, the user is using a browser on user 
device 102i that utilizes the JAVA Abstract Window 
Toolkit (AWT) . In another embodiment, a native C- 

15 programming language plug- in is used in the browser on 
user device 102 i to implement this invention. As is 
known to those of skill in the art, the AWT is a set of 
JAVA classes and interfaces that are mapped to a 
concrete implementation on each different platform. The 

2 0 sequence displayed in Figures 5A to 5D is for a JAVA- 
enabled system. 

When the user requests an application on the 
server, a JAVA bean, an object StarBean 511, is 
instantiated. Object StarBean 511 automatically issues 

2 5 a call to a method connect in the API of an object 

connection 512. The call to method connect includes a 
URL to server 100 on which application suite 120 is 
located. 

In response to the call to method connect, object 
30 connection 512 calls method connect in object 

connector 513. In this embodiment, server 100 runs a 
daemon process 52 0, sometimes called daemon 52 0 that 
includes an object ServiceFactory 521 that accepts 
Internet Inter-OrB Protocol (HOP) connections. In 

3 5 response to the call to method connect, connector 

object 513 makes a connection with daemon process 520 on 
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server 100 and stores a handle object ServiceFactory 521 
of daemon 52 0. 

Upon completion of the connection to daemon 
process 520, connection object 512 calls method 
5 getFactory ("Daemon") in the API of object connector 513 
to obtain the handle for object ServiceFactory 521. 

Next, object StarBean 511 calls method login in the 
API of object Connection 512 with a user identification, 
a password, and options for application suite 120 on 

10 server 100, which in this embodiment is the STAROFFICE 
suite of components. In response to the call to method 
login, object Connection 512 calls method createlnstance 
in the API of object ServiceFactory 521 of daemon 52 0, 
and specifies that an instance of the login service is 

15 needed. 

Object ServiceFactory 521 instantiates object 
LoginService 522 by calling method activate in the API 
of object LoginService 522. Object ServiceFactory 521 
returns a handle to object LoginService 522 to object 

20 connection 512. 

Object connection 512 calls method login of object 
LoginService 522 with the user identification, password, 
and options. In response to the login call, object 
LoginService 522 runs method validateLogin to validate 

25 the login request. If the login request is valid, 

object LoginService 522 starts application suite 120 as 
a new process on server 100 with the rights of the user 
with userlD. Object LoginService 522 calls method 
activate of the API of object ServiceFactory 531 to 

30 instantiate object ServiceFactory 531. 

Finally, to proceed with creating the 
infrastructure needed for application suite 120 and 
lightweight component 23 0 to work together, object 
connection 512, sometimes called connection object 512, 

35 calls method getFactory in object connector with an 
argument "Application" to get the handle to object 
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ServiceFactory 521 that in turn is stored in object 
Connection 512. Upon activation of object 
ServiceFactory 531 and return of its handle to object 
Connection 512, a connection is established between 
5 application suite 12 0 and lightweight component 23 0 so 
that the application suite 12 0 and lightweight 
component 23 0 can communicate directly over 
network 103/106. 

Upon object Connection 512 returning processing to 

10 object StarBean 511, object StarBean 511 calls method 
getObject ( "BeanService" ) in the API of object 
Connection 512. In method getObject, connection 
object 512 calls method createlnstance ( "BeanService " ) 
(Fig. 5B) in object ServiceFactory 531 and in turn 

15 object ServiceFactory 531 instantiates object 

BeanService 532 by calling method activate in the API of 
object BeanService 532. A handle to object 
BeanService 532 is returned to object StarBean 511 and 
is stored by object StarBean 511. 

20 Next, object StarBean 511 calls method start in the 

API of object BeanService 532. A handle to object 
ClientFactory 515 is passed in the call to method start 
so that application suite 120 can create windows and any 
other components on client device 102 i needed by 

25 application suite 120. 

To create the infrastructure needed to run 
application suite 12 0 on server 100, object StarBean 512 
calls method createBeanWindow of object BeanService 532. 
Object BeanService 532 then calls method 

3 0 createlnstance ( "RmFramewindow" ) in the API of object 
ClientFactory 515 and object ClientFactory 515 
initializes remote frame window object 514 on user 
device 102i. 

Following creation of remote frame window 

35 object 514 on user device 102i, object BeanService 532 

calls initialize method init (RmFrameWindow) to create an 
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instance of object BeanWindow 534 to support remote 
frame window object 514. To further initialize object 
BeanWindow 534, object BeanWindow 534 sends one or more 
queries to object RmFrameWindow 514 to determine the 
5 display capabilities of user device 102i. 

Finally, object BeanService 532 calls method 
init (Window) to instantiate and initialize object 
BeanFrame 533 for application suite 120. Object 
BeanFrame 533 controls the environment for this instance 

10 of application suite 120. For example, object 

BeanFrame 533 controls the lifetime of components of the 
user interface on client device 102 i used by application 
suite 12 0, the loading of such components, and so on. A 
handle to object BeanFrame 533 is returned to and stored 

15 by object StarBean 511. 

Upon receiving the handle to object BeanFrame 533, 
object StarBean 511 calls method loadDocument (url) in 
the API of object BeanFrame 533 (Fig. 5C) . Here, url is 
an address, e.g., a uniform resource locator, of the 

2 0 document requested by the user. Object BeanFrame 553 

can determine which component is requested in a number 
of ways. For example, object BeanFrame 533 can ask the 
underlying transport component for a content type, or 
perhaps look at the first few bytes of an available 
25 number. As a last resort, the extension of the address 
is used by object BeanFrame 533 to determine which 
component within application suite 120 to launch. 
Independent of the technique used to identify the 
requested runtime environment component, after 

3 0 identifying the component in this embodiment, object 

BeanFrame 533 calls method init (Window) in component 
StarWriter 53 5 in the STAROFFICE application suite. 

In this embodiment, the component initialized by 
BeanFrame 533 must use the remote VCL and only it to 
35 handle user interface input/output. However, no other 
modifications are required to work in this environment. 
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Any prior art application that works in a windowing 
graphic user interface could be used in place of 
component StarWriter so along as it included the 
functionality provided by the remote VCL and used only 
5 that functionality to handle user interface 
input /output . 

After component StarWriter 535 is initialized, 
object BeanFrame 533 calls method load(url) in the API 
of component StarWriter 535. Component StarWriter 535 

10 loads the document at the address specified in method 
load and performs methods readDocument and do Layout . 
Upon completing the window layout, component StarWriter 
calls method show in the API of object BeanWindow 534, 
and in response, object BeanWindow 534 calls method show 

15 in the API of object RemoteFrameWindow 514. Object 
RemoteFrameWindow 514 causes the window generated by 
component StarWriter 53 5 to be displayed on display 
screen 295 of user device 102i. 

Similarly, as the user of user device 102 i performs 

20 an input action on the information displayed, the 
appropriate input event is transmitted from object 
RmFrameWindow 514 to object BeanWindow 53 3 and in turn 
to component StarWriter 535. Conversely, each call to a 
method in the graphic user interface, e.g., method 

25 drawLine, method drawText, etc., is made to the API of 

object BeanWindow 533 and a corresponding method call is 
made to a method in the API of object RmFrameWindow 514 
by object BeanWindow 533. 

Figure 5D is an example of the processing of a 

3 0 mouse click by the user. In this example, the mouse 

click event is handled by the AWT panel, which in turn 
calls method onMouseClick (x, y) of object 
RmFrameWindow 514. Remote frame window object 514, in 
response, calls method MouseEvent (x, y) of object 

35 BeanWindow 534. 
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Object BeanWindow 534 runs method processUI event to 
determine the particular event that occurred, and calls 
an appropriate method in the API of component 
StarWriter 535. In this example, object BeanWindow 534 
5 calls method applicationEvent (ButtonClicked) in the API 
of component StarWriter 535. 

In response to the method call, component 
StarWriter 535 runs methods processApplicationEvent , re- 
layout, and re-draw. Method re-draw calls the 
10 appropriate methods in object BeanWindow 534 that in 
turns issues corresponding method calls to object 
RmFrameWindow . 

In the embodiment of Figures 5A to 5D, objects 531 
O to 534 are an example of a user interface infrastructure 

J1 15 that receives graphic user interface events from user 

!Ji device 102i, and that the runtime environment component 

service sends remote graphic user interface commands . 
fg Here, commands are the calls to the various methods in 

P the interfaces of the objects. A local command is one 

20 on system 100. A remote input action command is a 
M= command sent from lightweight component 23 0 on user 

device 102i to the user interface infrastructure on 
Q system 100 in response to a user input. A remote output 

command is a command sent by the user interface 
25 infrastructure on system 100 to lightweight component 
230 on user device 102i. Similarly, object BeanFrame 
533 is an example of a local frame object, and object 
BeanWindow 534 is an example of a local window object. 
Thus, objects and actions on system 100 are considered 
30 local, while objects and actions on user device 102i are 
considered remote . 

Figure 6 is one embodiment of a class diagram for 
the sequence diagram of Figures 5A to 5D. Figures 7, 8A 
to 8C, 9, 10A and 10B illustrate one embodiment of 
3 5 interfaces, structures, enumerations and exceptions 

associated with each interface illustrated in Figure 6 
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and give a corresponding Table number for each in the 
description that follows. The names of elements, e.g., 
interfaces, structures, exceptions, enumerations, 
strings, constants, etc., are indicative of the nature 
of the particular element. 

In this embodiment of the invention, remote frame 
window class RmFrameWindow (Figure 6) includes a remote 
frame window interface XRmFrameWindow (Table 1) and a 
remote output device interface XRmOutputDevice 
(Table 8) . Interface XRmFrameWindow inherits from 
interface XInterfa.ce (Table 2 and Fig. 7) and uses 
interface XEventHdl (Table 4) . Interface 
XRmFrameWindow, in the embodiment of Table 1, includes 
methods Create, ReleaseWindow, SetTitle, Show, 
SetClientSize, GetClientSize , SetWindowState , 
GetFontResolution, GetFrameResolut ions , ToTop, 
StartPresentation, SetAlwaysOnTop, ShowFullScreen, 
CaptureMouse, SetPointer, SetPointerPos , Beep, 
GetKeyNames, Enable, Set Icon, SetMinClientSize , 
MouseMoveProcessed, and KeylnputProcessed . (Herein, an 
italicized phrase and the same phase that is not 
italicized are the same phrase.) 

Method ReleaseWindow notifies the client, that the 
window connected to this interface is not needed by the 
server anymore. Whether the real window is destroyed 
and a new one created on the next call of Create or the 
real window is cached is up to the client 
implementation . 

TABLE 1 . : Interface XRmFrameWindow 



typedef sequence< IDLKeyNamelnf o , 1 > KeyNameSequence ; 

interface XRmFrameWindow : 

com: :sun: :star: :uno: :XInterface 
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{ 

[oneway] void Create ( [in] unsigned long nWinBits, 
[in] XEventHdl xEvent Interface , [in] any 

aSystemWorkWindowToken, [in] XRmFrame Window 

xParent ) ; 
[oneway] void ReleaseWindow ( ) ; 

[oneway] void SetTitle ( [in] string rTitle ) ; 
[oneway] void Show ( [in] boolean bVisible ) ; 
[oneway] void SetClientSize ( [in] short nWidth, [in] 

short nHeight ) ; 
void GetClientSize ( [out] short rWidth, [out] short 

rHeight ) ; 
string GetWindowState ( ) ; 

[oneway] void SetWindowState { [in] string aState ) ; 
void GetFontResolution ( [out] long nDPIX, [out] long 
nDPIY ) ; 

RmFrameResolutions GetFrameResolutions ( ) ; 
[oneway] void ToTop ( [in] unsigned short nFlags ) ; 
[oneway] void StartPresentat ion ( [in] boolean 

bStart, [in] unsigned short nStartFlags ); 
[oneway] void SetAlwaysOnTop ( [in] boolean bOnTop ); 
[oneway] void ShowFullScreen ( [in] boolean bFullScreen) ; 
[oneway] void CaptureMouse ( [in] boolean bMouse ) ; 
[oneway] void SetPointer ( [in] unsigned short 

ePointerStyle ) ; 
[oneway] void SetPointerPos ( [in] short nX, [in] short 

nY ) ; 

[oneway] void Beep ( [in] unsigned short eSoundType ) ; 

void GetKeyNames ( [out] KeyNameSequence rKeyNames ) ; 
[oneway] void Enable ( [in] boolean bEnable ); 
[oneway] void SetIcon( [in] short IconID ); 
[oneway] void SetMinClientSize ( [in] short Width, [in] 
short Height ) ; 

[oneway] void MouseMoveProcessed { ) ; 
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[oneway] void KeylnputProcessed ( ) ; 

}; 



Interface XInterfa.ce (Table 2) is the base 
interface for other interfaces and provides lifetime 
control by reference counting. Interface XInterfa.ce 
5 also provides the possibility of querying for other 

interfaces of the same logical object. Logical object 
in this case means that the interfaces actually can be 
supported by internal, i.e., aggregated, physical 
obj ects . 

10 Method queryln terface in interface XInterface 

queries for a new interface to an existing object. 
Method acquire increases a reference counter by one, 
while method release decreases the reference counter by 
one . When the reference counter reaches a value of 

15 zero, the object is deleted. 

TABLE 2 . : INTERFACE XIn terface 



// =================================================== 

interface XInterface 
{ 

// 

/** queries for a new interface to an existing 
obj ect . 

©param aUik 

specifies the Uik of the interface to 
be queried. 

©param ifc 

returns the new interface if the method 
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succeeds . 
©returns 

<TRUE/> if the UNO object to which this 
interface referred supports the 
interface denoted by parameter aUik. 

*/ 

any querylnterf ace ( [in] type aType ) ; 

//boolean querylnterf ace ( [in] 
//com: :sun: :star: :uno: :Uik aUik, 
// [out] any if c ) ; 

// 

/** increases the reference counter by one. 

*/ 

[oneway] void acquire (); 

// 

/** decreases the reference counter by one. 

When the reference counter reaches 0, the object 

gets deleted. 

*/ 

[oneway] void release!) ; 

}; 

//= == = == ============= = =======™======================= 



One embodiment of structure Uik in interface 
XInterfa.ce is presented in Table 3. 

5 TABLE 3 . : Structure Uik 
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//=============================================== 

/** specifies a universal interface key. 

An UIK is an unambiguous 16-byte value for every 

interface . 

*/ 

struct Uik 
{ 

// 

// specifies a 4 byte data block, 
unsigned long m_Datal; 

// 

/// specifies a 2 byte data block, 
unsigned short m_Data2 ; 

// 

/// specifies a 2 byte data block, 
unsigned short m_Data3 ; 

// 

/// specifies a 4 byte data block, 
unsigned long m_Data4 ; 

// 

/// specifies a 4 byte data block, 
unsigned long m_Data5 ; 



// = 



Method Create in interface XRmFrameWindow of class 
RmFrameWindow (Fig. 6) includes as an input a reference 
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to an event handler interface XEventHdl (Table 4) . 
Class BeanWindow (Fig. 6) also uses event handler 
interface XEventHdl. In this embodiment, interface 
XEventHdl inherits from interface XInterfa.ce (Table 2) 
5 and uses a structure RmDropFileEvent (Table 5) . 

Interface XEventHdl includes methods MouseButtonUp, 
MouseButttonDown, MouseMove, MouseWheel, Keylnput, 
KeyUp, Paint, Resize, GetFocus, LoseFocus, Close, 
QueryDropFile, DropFile, and Us er Event . 
10 One embodiment of structure RmDropFileEvent that is 

passed in the call to method RmDropFileEvent is 
presented in Table 5. 

TABLE 4 . : INTERFACE XEventHdl 



interface XEventHdl : com: : sun: : star : :uno : :XInterf ace 
{ 

[oneway] void MouseButtonUp ( [in] short nX, [in] short 
nY, [in] unsigned short nMode, [in] unsigned short 
nCode, [in] unsigned long nSysTime ) ; 

[oneway] void MouseButtonDown ( [in] short nX, [in] 

short nY, [in] unsigned short nMode, [in] unsigned 
short nCode, [in] unsigned long nSysTime ) ; 

[oneway] void MouseMove ( [in] short nX, [in] short nY, 
[in] unsigned short nMode, [in] unsigned short 
nCode, [in] unsigned long nSysTime ) ; 

[oneway] void MouseWheel ( [in] long nX, [in] long nY, 
[in] unsigned short nCode, [in] unsigned long 
nSysTime , [in] long nDelta, [in] long 
nNotchDelta, [in] unsigned long nScrollLines , [in] 
boolean bHorz) ; 

[oneway] void Keylnput ( [in] unsigned short nKeyCode, 
[in] unsigned short nChar, [in] unsigned short 
nCount ) ; 

[oneway] void KeyUp ( [in] unsigned short nKeyCode, 
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[in] unsigned short nChar ) ; 
[oneway] void Paint ( [in] long nX, [in] long nY, [in] 

long nWidth, [in] long nHeight ) ; 
[oneway] void Resize ( [in] short nWidth, [in] short 

nHeight ) ; 
[oneway] void GetFocusO; 
[oneway] void LoseFocusO ; 

boolean QueryDropFile ( [inout] 

RmDropFileEvent rDropFileEvent ) ; 
boolean DropFile ( [in] RmDropFileEvent 

aDropFileEvent ) ; 
[oneway] void Close (); 

[oneway] void UserEvent ( [in] unsigned long EventID, 
[in] any Parameter ) ; 



TABLE 5. Structure RmDropFileEvent 



typedef sequence< string > FileNameSequence ; 



struct RmDropFileEvent 
{ 

short 
short 

F i 1 eName Sequence 
unsigned short 
unsigned short 
byte 
boolean 

}; 



nX; 
nY; 

aFi 1 eNameSequence ; 
nDropAc t i on ; 
nSourceOpt ions ; 
nWindowType ; 

blsDef ault ; 
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Structures used in interface XRmFrameWindow 
(Table 1 and Fig. 7) include structure 
RmFrameResolutions (Table 6) and structure 
5 IDLKeyNamelnf o (Table 7) . 

TABLE 6 . : Structure RmFrameResolutions 



struct RmFrameResolutions 
{ 

long DPIx; 

long DPIy; 

long Font DPIx ; 

long FontDPIy; 

unsigned short Depth; 

}; 



TABLE 7 . : Structure IDLKeyNamelnf o 



struct IDLKeyNamelnf o 
{ 

unsigned short nCode; 
string aName ; 

}; 



As illustrated in Fig. 6, class RmFrameWindow 
includes remote output device interface XRmOutputDevice 
(Table 8) . Interface XRmOutputDevice inherits from 
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interface XInterface (Table 2) , and uses structures 
IDLFontMetricData, KernPair, IDLFontData, IDLFont 
(Table 9) . In the embodiment of Table 8, interface 
XRmOutputDevice includes methods QuerySvOutputDevicePtr , 
5 SetClipRegion, ResetClipRegion, GetResolution, 
GetCharWidth, GetFontMetric , GetKernPairs , 
GetDevFontList , AddFontAtom, GetGlyphBoundRect , 
GetGlyphOutline, GetPixel, GetPixelArray , SetFont, 
SetTextColor, SetLineColor , SetFillColor , SetRasterOp, 

10 CopyArea, CopyBits, Invert, Invert Polygon, 

InvertTracking, Invert TrackingPolygon, DrawPixel , 
DrawColoredPixel , DrawPixelArray , DrawLine, DrawRect , 
DrawPolyLine , DrawPolygon, DrawPolyPolygon, DrawEllipse, 
DrawArc, DrawPie, DrawCord, DrawGradient , 

15 DrawPolyPolyGradient, DrawPolyPolyHatch, DrawText , 
DrawText Array, DrawWaveLine , DrawGrid, 
DrawPolyPolyTransparent , and Draw2ColorFrame . 

TABLE 8.: Interface XRmOutputDevice 
2 0 



interface XRmOutputDevice : 

com: :sun: :star: :uno: : XInterface 

{ 

unsigned long QuerySvOutputDevicePtr () ; 
[oneway] void SetClipRegion ( [in] ByteSequence aData 
) ; 

[oneway] void ResetClipRegion () ; 

void GetResolution ( [out] long nDPIX, [out] long 
nDPIY, [out] unsigned short nBit Count ) ; 

sequence< long > GetCharWidth ( [in] unsigned short 
nStart, [in] unsigned short nEnd ) ; 

void GetFontMetric ( [out] IDLFontMetricData 

rFontMetric, [in] unsigned short nFirstChar, [in] 
unsigned short nLastCar, [in] boolean 
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bGetKernPairs ) ; 
sequence< KernPair > GetKernPairs ( ) ; 
void GetDevFontList ( [out] sequence< string > 

FontNameAtoms, [out] sequence< string > 

StyleNameAtoms, [out] IDLFontDataSequence 

rFontData ) ; 

[oneway] void AddFontAtom ( [in] byte Type, [in] string 

Name, [in] unsigned short Atom ) ; 
boolean GetGlyphBoundRect ( [in] unsigned short cChar, 

[out] long nX, [out] long nY, [out] long nWidth, 

[out] long nHeight, [in] boolean bOptimize ) ; 
boolean GetGlyphOut line ( [in] unsigned short cChar, 

[out] ByteSequence rPoly, [in] boolean bOptimize 

) ; 

void GetPixel ( [in] long nX, [in] long nY, [out] 

unsigned long nColor ) ; 
void GetPixelArray ( [in] ByteSequence aData, [out] 

ULongSequence aColors ) ; 
[oneway] void SetFont ( [in] IDLFont aFont ) ; 
[oneway] void SetTextColor ( [in] unsigned long nColor 
) ; 

[oneway] void SetLineColor ( [in] unsigned long nColor 
) ; 

[oneway] void SetFillColor ( [in] unsigned long nColor 
) ; 

[oneway] void SetRasterOp ( [in] unsigned short nROP ); 

[oneway] void CopyArea ( [in] long nSrcX, [in] long 
nSrcY, [in] long nSrcWidth, [in] long 
nSrcHeight, [in] long nDestX, [in] long nDestY, 
[in] unsigned short nFlags ) ; 

[oneway] void CopyBits( [in] long nSrcX, [in] long 

nSrcY, [in] long nSrcWidth, [in] long nSrcHeight, 
[in] long nDestX, [in] long nDestY, [in] long 
nDestWidth, [in] long nDestHeight, [in] 
XRmOutputDevice xFrom ) ; 

[oneway] void Invert ( [in] long nX, [in] long nY, [in] 
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long nWidth, [in] long nHeight, [in] unsigned 

short nFlags ) ; 
[oneway] void InvertPolygon ( [in] ByteSequence 

aPolygon, [in] unsigned short nFlags ) ; 
[oneway] void InvertTracking ( [in] long nX, [in] long 

nY, [in] long nWidth, [in] long nHeight, [in] 

unsigned short nFlags ) ; 
[oneway] void InvertTrackingPolygon ( [in] ByteSequence 

aPolygon, [in] unsigned short nFlags ) ; 
[oneway] void DrawPixel ( [in] long nX, [in] long nY ); 
[oneway] void DrawColoredPixel ( [in] long nX, [in] 

long nY, [in] unsigned long nColor ) ; 
[oneway] void DrawPixelArray ( [in] ByteSequence aData, 

[in] ULongSequence aColors ) ; 
[oneway] void DrawLine ( [in] long nStartX, [in] long 

nStartY, [in] long nEndX, [in] long nEndY ) ; 
[oneway] void DrawRect ( [in] long nX, [in] long nY, 

[in] long nWidth, [in] long nHeight ) ; 
[oneway] void DrawPolyLine ( [in] ByteSequence aData ) ; 
[oneway] void DrawPolygon ( [in] ByteSequence aData ); 
[oneway] void DrawPolyPolygon ( [in] ByteSequence aData 
) ; 

[oneway] void DrawRoundedRect ( [in] long nX, [in] long 
nY, [in] long nWidth, [in] long nHeight, [in] 
unsigned long nHorzRound, [in] unsigned long 
nVertRound ) ; 

[oneway] void DrawEllipse( [in] long nX, [in] long nY, 
[in] long nWidth, [in] long nHeight ) ; 

[oneway] void DrawArc ( [in] long nX, [in] long nY, 
[in] long nWidth, [in] long nHeight, [in] long 
nStartX, [in] long nStartY, [in] long nEndX, [in] 
long nEndY ) ; 

[oneway] void DrawPie ( [in] long nX, [in] long nY, 
[in] long nWidth, [in] long nHeight, [in] long 
nStartX, [in] long nStartY, [in] long nEndX, [in] 
long nEndY ) ; 
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[oneway] void DrawChord ( [in] long nX, [in] long nY, 
[in] long nWidth, [in] long nHeight , [in] long 
nStartX, [in] long nStartY, [in] long nEndX, [in] 
long nEndY ) ; 

[oneway] void DrawGradient ( [in] long nX, [in] long 
nY ; [in] long nWidth, [in] long nHeight, [in] 
ByteSequence aData ) ; 
[oneway] void DrawPolyPolyGradient ( [in] ByteSequence 

aPolyPolyData, [in] ByteSequence aGradientData ) ; 
[oneway] void DrawPolyPolyHatch ( [in] ByteSequence 

aPolyPolyData, [in] ByteSequence aHatchData ) ; 
[oneway] void DrawText ( [in] long nX, [in] long nY, 

[in] string aText ) ; 
[oneway] void DrawTextArray ( [in] long nX, [in] long 

nY, [in] string aText, [in] LongSequence aLongs ) ; 
[oneway] void DrawWaveLine ( [in] long nStartX, [in] 

long nStartY, [in] long nEndX, [in] long nEndY, 

[in] unsigned short nStyle ) ; 
[oneway] void DrawGrid ( [in] long nMinX, [in] long 

nMaxX, [in] sequence< long > aHorzValues, [in] 

long nMinY, [in] long nMaxY, [in] sequence< long 

> aVertValues, [in] unsigned long nFlags ) ; 
[oneway] void DrawPolyPolyTransparent ( [in] 

ByteSequence aData, [in] unsigned short 

nTransparencyPercent ) ; 
[oneway] void Draw2ColorFrame ( [in] long x, [in] long 

y, [in] unsigned long width, [in] unsigned long 

height, [in] unsigned long lef tAndTopColor , [in] 

unsigned long rightAndBottomColor ) ; 

}; 



In one embodiment, method GetFontMetric (Table 8) 
gets the general metrics of the current font. If the 
value of inputs nFirstChar and nLastChar are not equal, 
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member maCharWidths of output structure 

IDLFontMetricData (Table 9) is filled as it would be in 
a call by method GetCharWidth and so saves one 
synchronous call. If the Boolean input value of 
5 variable bGetKernPairs is true, member maKerningPairs of 
output structure IDLFontMetricData is filled as it would 
be in a call to method GetKernPairs, and this saves 
another synchronous call. 

In method AddFontAtom, Type is a FontAtomType ; Name 
10 is the new atom string; and Atom the new atomic value 

In Table 9, a brief description of given of the 
values in the various structures. 

TABLE 9 . Structure and Other Information Used by 
15 Interface XRmOutputDevice 



J I [in] Eingabe - Parameter . Der "Server" auf dem das 
Object liegt // ist der Remote -Client . 
// Also "Server" eigentlich "Display" 

// [oneway] => Kein wart en auf Antwort 

struct KernPair 
{ 

unsigned short 
unsigned short 
short 

}; 

struct IDLFontMetricData 
{ 

// these data must be set 

/ / Durchschnittsbreite vom Font in Pixeln (must same as 
by SetFont) 

short mnWidth; 



Charl; 
Char2 ; 
Kerning ; 
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// Ascent 



short 



innAscent ; 



// Descent 



short 



mnDescent ; 



// Internal -Leading 



short 



mnLeading ; 



// Schraegstellung (bei Italic) 



/ / Erstes druckbare Zeichen im Font 

unsigned short mnFirstChar; 

// Letztes druckbare Zeichen im Font 

unsigned short mnLastChar; 

/ / this data should be overwritten 

// Font name : Atom 

unsigned short ranName ; 

/ / Stylename : Atom 

unsigned short mnStyleName; 

/ / Rotation 

short mnOrientation; 

// Family vom Font 

byte meFamily; 

// CharSet vom Font 

byte meCharSet ; 

// Weight vom Font 

byte meWeight; 

// Italic vom Font 

byte meltalic; 

/ / Pitch vom Font 

byte mePitch; 

// Type vom Font 

byte meType; 

// 1st es ein Device-Font 

boolean mbDevice; 

/ / factor for charwidths 

long ranFactor; 

sequence< long > maCharWidths ; 



short 



mnSlant ; 
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sequence< KernPair > maKerningPairs ; 



struct IDLFontData 
{ 

// Struktur zum Abfragen der DevFontList 

// Name vom Font: Atom 

unsigned short ranName; 

// StyleName vom Font: Atom 

unsigned short mnStyleName ; 

// Breite vom Font in Pixeln 

short mnWidth; 

/ / Heoehe vom Font in Pixeln 

short mnHeight; 

// Family vom Font 

byte meFamily; 

// CharSet vom Font 

byte meCharSet ; 

// Pitch vom Font 

byte mePitch; 

// WidthType vom Font 

byte meWidthType ; 

// Weight vom Font 

byte meWeight; 

// Italic vom Font 

byte meltalic; 

// Type vom Font 

byte me Type ,- 

// bitO: mborientation 

//bit 1: mbDevice 

byte mnBool s ; 



struct IDLFont 
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// Struktur zura Setzen eines Fonts 



unsigned short 

unsigned short 

short 

short 

byte 

byte 

byte 

byte 

byte 

byte 

short 



mnName ; 
mnStyleName; 
mnWidth; 
mnHeight ; 
me Family ; 
meCharSet ; 
meWidthType ; 
meWeight ; 
meltalic; 
mePitch; 
mnOrientat ion; 



typedef sequence< byte, 1 > ByteSequence ; 

typedef sequence< long, 1 > LongSequence ; 

typedef sequence< unsigned long, 1 > ULongSequence ; 

typedef sequence< unsigned short , 1 > UShort Sequence ; 

typedef sequence< IDLFontData, 1 > IDLFontDataSequence ; 



constants FontAtomType 
{ 

const byte NAME = 0 ; 
const byte STYLE = 1 ; 

}; 



In Figure 6, class ClientFactory includes interface 
XMultilnstanceFactory (Table 10 and Fig. 7) . Class 
ClientFactory is called by an object BeanFrame to 
generate multiple instances of class RmFrameWindow. 
Interface XMultilnstanceFactory inherits from interface 
XJnterface (Table 2) . 



TABLE 10.: INTERFACE XMultilnstanceFactory 



interface XMultilnstanceFactory : 

com: :sun: :star: :uno: :XInterface 

{ 

sequence<any> createlnstances ( 
[in] string aObjectName, 
[in] long nCount) ; 

}; 



In Figure 6, class ServiceFactory include interface 
XMultiServiceFactory (Table 11 and Fig. 7) . Class 
ServiceFactory is called by an object connector to 
generate objects LoginService and BeanService . 
Interface XMultiServiceFactory inherits from interface 
^Interface (Table 2) and throws an exception Exception 
(Table 12) . 

TABLE 11.: INTERFACE XMultiServiceFactory 



interface XMultiServiceFactory: 

com: :sun: : star : :uno: :XInterface 

{ 

com: : sun: : star: :uno: :XInterf ace createlnstance ( [in] 
string aServiceSpecif ier ) 

raises ( com :: sun :: star :: uno :: Except ion ) ; 
com: :sun: :star: :uno: :XInterface 

createlnstanceWithArguments ( 

[in] string ServiceSpecif ier , 
[in] sequence < any > Arguments ) 
raises ( com :: sun :: star :: uno :: Except ion ) ; 
sequence<string> getAvailableServiceNames ( ) ; 

}; 
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The service factory objects support this interface 
for creating components by a specifying string, i.e. the 
service name. In the embodiment of Table 11, interface 
5 XMul tiServiceFactory includes methods createlnstance , 
createlnstanceWithArguments , and 
getAvailableServiceNames . 

Method createlnstance creates an instance of a 
component which supports the services specified by the 

10 factory. Input parameter ServiceSpecif ier is a service 
name that specifies the service that should be created 
by this factory 

Method createlnstanceWithArguments creates an 
instance of a component which supports the services 

15 specified by the factory. Input parameter aArguments is 
the values of the arguments that depend on the service 
specification of the factory. Normally the factory 
delegates the arguments to the method init() of the 
created instance. The factory is explicitly allowed to 

2 0 modify, delete or add arguments. The conversion rules 
of the arguments are specified by a converter service. 
Input parameter ServiceSpecif ier is a service name that 
specifies the service that should be created by this 
factory. 

2 5 Method getAvailableServiceNames returns a sequence 

of all service identifiers, which can be instantiated. 

Table 12 presents one embodiment of exception 
Exception that is used by interface 
XMu ItiServiceFactory. 

30 

TABLE 12.: EXCEPTION Exception 



exception Exception 
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{ 

string Message; 

com: :sun: :star: :uno: :XInterface Context; 

}; 



In this embodiment, exception Exception is the 
basic exception from which all other exceptions are 
derived. Parameter Message specifies a detailed message 
of the exception or an empty string if the callee does 
not describe the exception. Context is an object that 
describes the reason for the exception. Object Context 
may be NULL if the callee does not describe the 
exception . 

Service LoginService that is instantiated by object 
ServiceFactory of the daemon includes an interface 
XLogin (Table 13 and Fig. 7) . Interface XLogin inherits 
from interface XInterface and uses an enumeration 
Resul tof Login . 

TABLE 13 . : INTERFACE XLogin 



enum Resultof Login 
{ 

OK, 

NO_LICENSE, 

ALRE AD Y_LOGGED_ I N , 

S E CUR I T Y_V I OLAT I ON , 

COULD_NOT_TO_FILESERVER, 

NO_CONF I GURAT I ON , 

UNKNOWN_ERROR 

}; 

interface XLogin: com: :sun: : star : :uno: : XInterface 
{ 
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Boolean installationHasBeenCompleted ( [in] string 

sNameOfUser ) ; 
void completelnstallation ( [in] string sNameOf User , 

[in] string sPassword ) ; 
ResultofLogin login ( [in] string sNameOfUser, [in] 

string sPassword, [in] string sNameOf Workstation, 
[in] string sParameter ) ; 
string getQualif iedNameOf User ( [in] string 

sNameOfUser ) ; 

}; 



In the embodiment of Table 13, interface XLogin 
includes methods installationHasBeenCompleted, 
completelnstallation, login, and getQualif iedNameOf User . 

Class BeanService includes an interface 
XRmStarOffice in the embodiment of Figure 6. One 
embodiment of interface XRmStarOffice is presented in 
Table 14. Interface XRmStarOffice inherits from 
interface XJnterface and uses interfaces 
XMultiServiceFactory (Table 11} and XRmFrameWindow 
(Table 1). See Figure 7. 

TABLE 14 .: INTERFACE XRmStarOffice 



typedef enum _StartUpError { 
S 0 F F I CE_NO_ERROR , 
SOFFICE_WRONG_LOGIN, 
SOFF I CE_SERVI CE_NOT_FOUND , 
SOFFICE_CONNECTION_REFUSED, 
S 0 F F I CE_NO_L I CENSE , 
SOFF I CE_UNKNOWN_ERROR , 
SOFFI CE_ALREADY_STARTED 

} StartUpError ; 
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constants StarOf f iceServerType 
{ 

const long APP SERVER = 0 ; 

const long BEANSERVER = 1 ; 
const long ONE SERVER = 2 ; 

}; 

interface XRmStarOf f ice : 

com: :sun: : star : :uno: :XInterface 

{ 

/** AppName+Params+Version+Language, weil ueber den 
Demon dann spaeter auch andere Programme gestartet 
werden koennen. . . 
*/ 

StartUpError Start ( 

[in] com: :sun: :star: :lang: :XMultiServiceFactory 

xClient Factory, 
[in] string aConnectionName , 
[in] string aUserName, 
[in] string aPassword, 
[in] string aFileServer, 
[in] string aClientSystemName , 
[in] string aAppName, 
[in] string aAppParams, 
[in] unsigned long nAppLanguage , 
[in] unsigned long nRemoteVersion, 
[in] long servertype 

) ; 

[oneway] void SetUserlnf oForPrinting ( 
[in] string AuserName, 
[in] string aPassword ) ; 
void AddRemotePrinter ( 
[in] string aName, 
[in] string aServer, 
[in] boolean bSetAsDef ault , 
[in] boolean blsLocal ) ; 
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com: : sun : 



[in] 
[in] 



star: :uno: :XInterface CreateBeanWindow ( 
XRmFrameWindow xFrameWin, 

com: :sun: :star: :lang: : XMult iServiceFactory 



[in] 



xClient Factory, 
any aSystemWindowToken ) ; 



} 



In the embodiment of Table 14, interface 
XRmStarOffice includes methods Start, 
SetUserlnf oForPrinting, AddRemotePrinter , and 
5 CreateBeanWindow. Method start receives as input a 
reference to object ClientFactory , a user name, a 
password, identification of a file server, and a 
specification of the application that is to be started, 
e.g., parameters application name, application 

10 parameters, application language, and version. Method 
CreateBeanWindow receives a reference to object 
RmFrameWindow , and object ClientFactory as inputs. 

Class BeanFrame (Fig. 6) includes two interfaces, 
interface XFrame (Table 15) and interface 

15 XDispatchProvider (Table 62 and Fig. 9) . In the 

embodiment of Table 15, interface XFrame inherits from 
interface XComponent (Table 16) . Interface XFrame uses 
interfaces XWindow (Table 19) , XController (Table 53 and 
Fig. 8C) , and XFrameActionListener (Table 59 and Fig. 

20 8C) . As illustrated in Figures 8A to 8C, each of these 
interfaces uses other interfaces, structures, 
exceptions, and enumerations that are described more 
completely below. 



25 includes methods initialize, setCreator, getCreator, 
getName, setName, findFrame, isTop, activate, 
deactivate, setComponent , getComponentWindow, 



In the embodiment of Table 15, interface XFrame 
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getController, context Changed, addFrameActionListener , 
and removeFrameActionListener 

TABLE 15.: INTERFACE XFRAME 



interface XFrame : com :: sun :: star :: lang : : XComponent 
{ 

void initialize ( [in] com: : sun :: star :: awt :: XWindow 
xWindow ) ; 

com: :sun: :star: : awt : : XWindow getContainerWindow ( ) ; 

[oneway] void setCreator ( 

[in] XFramesSupplier xCreator ) ; 

[const] XFramesSupplier getCreator ( ) ; 

[const] string getName ( ) ; 

[oneway] void setName ( [in] string aName ) ; 

com: : sun: : star :: frame :: XFrame f indFrame ( [in] string 
aTargetFrameName, [in] long nSearchFlags ) ; 

boolean isTopO; 

[oneway] void activate (); 

[oneway] void deact ivate ( ) ; 

boolean isActiveO; 

boolean setComponent ( [in] com: :sun: :star: : awt : :XWindow 
xComponentWindow, [in] 

com: :sun: :star: : frame : :XController xController ) ; 
[const] com: :sun: :star: : awt : : XWindow 
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getComponentWindow ( ) ; 
[const] XController getController ( ) ; 
void contextChangedO ; 
[oneway] void addFrameActionListener ( 

[in] XFrameActionListener xListener ) ; 
[oneway] void remove FrameAct ionListener ( [in] 
XFrameActionListener xListener ) ; 

}; 



Interface XFrame makes it possible to control a 
frame. Method initialize is called to initialize the 
frame within a window. Method getContainerWindow 
5 provides access to the window of the frame. Normally 
this is used as the parent window of the controller 
window. Method setCreator sets the frame container that 
created this frame. Only the creator is allowed to call 
method setCreator. Method getCreator returns the frame 

10 container that created this frame. Method getName 

returns the programmatic name of this frame. Method 
setName sets the name of the frame. Normally, the name 
of the frame is set initially. 

Method findFrame searches for a frame with the 

15 specified name. Frames may contain other frames, e.g., 
a frameset, and may be contained in other frames. This 
hierarchy is searched with this method. First some 
special names are taken into account, i.e. "", "_self", 
"_top", "_active" etc., flag nSearchFlags is ignored 

20 when comparing these names with parameter 

aTargetFrameName, and further steps are controlled by 
flag nSearchFlags. If allowed, the name of the frame 
itself is compared with the desired one, then (again, if 
allowed ) the method is called for all children of the 

25 frame. Finally, the method may be called for the parent 
frame (if allowed) . If no frame with the given name is 
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found, a new top frame is created if this is not 
suppressed by a special value of flag FrameSearchFlag . 
The new frame also gets the desired name. 

Method isTop determines if the frame is a top 
frame. In general, a top frame is the frame which is a 
direct child of a task frame or which does not have a 
parent. If a frame returns for this method, all calls 
have to stop the search at such a frame unless the flag 
FrameSearchFlag: : TASKS is set. 

Method activate activates this frame and thus the 
component within. At first, the frame sets itself as 
the active frame of its creator by calling 
FrameAction: :FRAME_ACTIVATED. The component within this 
frame may listen to this event to grab the focus on 
activation. For simple components, this can be done by 
a Frame Loader. Finally, most frames may grab the focus 
to one of its windows or forward the activation to a 
sub- frame . 

Method deactivate is called by the creator frame 
when another sub- frame is activated. At first the frame 
deactivates its active sub-frame, if any, and then 
broadcasts a Frame Action Event with 
FrameAction : : FRAME_DEACT I VAT I NG . 

Method isActive determines if the frame is active. 
Method setComponent sets a new component into the frame. 
Method getComponentWindow returns the current visible 
component in this frame. The frame is the owner of the 
window. Method getController returns the current 
controller within this frame. Normally, it is set by a 
frame loader. 

Method contextChanged notifies the frame that the 
context of the controller within this frame changed 
(i.e. the selection) . According to a call to this 
interface, the frame calls with 

FrameAction: : CONTEXT_CHANGED to all listeners, which are 
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registered using this frame. For external controllers, 
this event can be used to requery dispatches. 

Method addFrameActionListener registers an event 
listener, which is called when certain things happen to 
the components within this frame or within sub- frames of 
this frame. For example, it is possible to determine 
instantiation/destruction and activation/deact ivation of 
components. Method removeFrameActionListener 
unregisters an event listener, which was registered with 
addFrameActionListener () . 

Interface XFrame inherits from interface 
XComponent. One embodiment of interface XComponent is 
presented in Table 16. Interface XComponent inherits 
from interface XInterface (Table 2) and uses interface 
XEventListener that in turn uses structure EventObject. 
See Figure 8A. 

TABLE 16.: INTERFACE XComponent 



interface XComponent: com: : sun :: star :: uno :: XInterface 
{ 

void dispose () ; 

void addEventListener ( [in] XEventListener xListener ) ; 
void removeEventListener ( 

[in] XEventListener aListener ) ; 

}; 



Interface XComponent controls the lifetime of 
components. Actually the real lifetime of an object is 
controlled by references kept on interfaces of the 
object. There are two distinct meanings in keeping a 
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reference to an interface: first is to own the object; 
and second is to know the object. 

To prevent cyclic references from resulting in 
failure to destroy an object, references of interfaces 
to the object are allowed only (i) by the owner, (ii) if 
the reference is very temporary, or (iii) you are 
registered as an Event Listener at that object and 
cleared the reference when "disposing" is called. 

An owner of an object calls method dispose to 
dispose of the object. Only the owner of the object 
calls method dispose if the object should be destroyed. 
All objects and components must release the references 
to the objects. If the object is a broadcaster, all 
listeners are removed and method 

XEventListener: : disposing () is called on all listeners. 

Due to the importance of the concept of method 
XComponent :: dispose () , a figurative example is provided. 
Imagine there was a hole in the floor and some people 
around it were holding a box (our component) . Everyone 
who holds the box for a longer time than just 
temporarily (i.e. to put something in or get something 
out) has to watch a light bulb, which is attached to the 
box (listening to event XEventListener :: disposing ()) . 
Now, when the owner of the box switched the light on 
(calling method XComponent: -.dispose ()) , everybody 
holding the box had to take their hands off (clear the 
interface handles) . If and only if everyone did that, 
did the box fall (getting deleted) . However, only the 
owner is allowed to switch the light on! After method 
dispose is called, the instance has to throw exception 
DisposedException for all non-event -method calls and 
event -method calls have to be ignored. 

The following is an example of one embodiment. 

void dispose ( ) 

{ 

// make a copy 
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Listener [] aTmpListeners = MyListeners . clone () ; 

// clear all listeners (against recursion) 
MyListeners . clear ( ) ; 

// call all listeners 

EventObject aEvt = new Event Ob j ect () ; 
aEvt.xSource = this; 

for( i = 0; i &amp ,- It ; aTmpListeners . length; i++ ) 

aTmpListeners [i] .disposing ( aEvt ); 

} 

Method addEventListener adds an event listener to 
the listener list for the object. The broadcaster fires 
the disposing method of this listener if method 
dispose () is called. Conversely, method 
removeEventListener removes an event listener from the 
listener list for the object. 

As described above, interface XComponent uses 
interface XEventListener (Table 17.) 

TABLE 17.: INTERFACE XEventListener 



interface XEventListener: 

com: :sun: : star : :uno: :XInterface 

{ 

void disposing ( [in] com: : sun :: star :: lang :: EventObj ect 
Source ) ; 



Interface XEventListener (Table 17) inherits from 
25 interface XInterface (Table 2) . Interface 

XEventListener is a tagging interface that all event 
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listener interfaces must extend. Method disposing is 
called when the broadcaster is about to be disposed. 
All listeners and all other objects, which reference the 
broadcaster should release the references . One 
5 embodiment of structure EventObject is presented in 
Table 18. 

TABLE 18.: Structure EventObject 



struct EventObject 
{ 

com: :sun: :star: : uno : :XInterface Source; 

}; 



10 

Structure EventObject specifies the base for all 
event objects and identifies the source of the event. 
Field Source refers to the object that fired the event. 

As explained above, interface XWindow (Table 19) is 

15 used by interface XFrame (Table 15) . See also Fig. 8A. 
In the embodiment of Table 19, interface XWindow 
inherits from interface XComponent (Table 16) and uses 
interfaces XWindowListener (Table 21) , XFocusListener 
(Table 23) , XKeyListener (Table 25) , XMousehi stener 

20 (Table 28) , XMouseMotionLi stener (Table 30) , and 

XPaintLi stener (Table 31) , and structure Rectangle 
(Table 20) , each of which is described herein. 

TABLE 19.: INTERFACE XWindow 
25 _ 

interface XWindow: com :: sun :: star :: lang :: XComponent 
{ 

[oneway] void setPosSize ( [in] long X, [in] long Y, 
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[in] long Width, [in] long Height, [in] short 
Flags ) ; 

[const] com: : sun: : star: :awt :: Rectangle getPosSize ( ) ; 
[oneway] void setVisible ( [in] boolean Visible ); 
[oneway] void setEnable ( [in] boolean Enable ) ; 
[oneway] void setFocus ( ) ; 
[oneway] void addWindowListener ( [in] 

com: : sun :: star : : awt : : XWindowListener xListener ) 
[oneway] void removeWindowListener ( [in] 

com: -.sun: :star: : awt : : XWindowListener xListener ) 
[oneway] void addFocusListener ( [in] 

com: :sun: :star: : awt : :XFocusListener xListener ) ; 
[oneway] void removeFocusListener ( [in] 

com: : sun :: star :: awt : :XFocusListener xListener ) 
[oneway] void addKeyListener ( [in] 

com: :sun: :star: : awt : : XKeyListener xListener ) ; 
[oneway] void removeKeyListener ( [in] 

com: :sun: :star: : awt : :XKeyListener xListener ) ; 
[oneway] void addMouseListener ( [in] 

com: : sun :: star :: awt : :XMouseListener xListener ) 
[oneway] void removeMouseListener ( [in] 

com: :sun: :star: : awt : : XMouseListener xListener ) 
[oneway] void addMouseMotionListener ( [in] 

com: :sun: :star: :awt: : XMouseMot ionListener 

xListener ) ; 
[oneway] void removeMouseMot ionListener ( [in] 

com: :sun: :star: :awt: : XMouseMot ionListener 

xListener ) ; 
[oneway] void addPaintListener ( [in] 

com: :sun: : star : : awt : : XPaintListener xListener ) 
[oneway] void removePaintListener ( [in] 

com: : sun: : star: : awt :: XPaintListener xListener ) 
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Interface XWindow (Table 19) specifies the basic 
operations for a window component. A window is a 
rectangular region on an output device with a position, 
size, and internal coordinate system. The main sense of 
5 a window is to receive events from the user. 

Method setPosSize sets the outer bounds of the 
window. Method getPosSize returns the outer bounds of 
the window. Method setVisible shows or hides the window 
depending on the parameter. Method setEnable enables or 

10 disables the window depending on the parameter. Method 
setFocus sets the focus to the window. Method 
addWindowListener adds the specified component listener 
to receive component events from this window component . 
Method removeWindowListener removes the specified 

15 listener so it no longer receives component events from 
this window component. Method addFocusListener adds the 
specified focus listener to receive focus events from 
this window component. Method removeFocusListener 
removes the specified focus listener so it no longer 

20 receives focus events from this component. Method 
addKeyListener adds the specified key listener to 
receive key events from this component. Method 
removeKeyListener removes the specified key listener so 
it no longer receives key events from this component. 

25 Method addMouseListener adds the specified mouse 

listener to receive mouse events from this component. 
Method removeMouseListener removes the specified mouse 
listener so it no longer receives mouse events from this 
component . Method addMouseMotionListener adds the 

30 specified mouse motion listener to receive mouse motion 
events from this component. Method 

removeMouseMotionListener removes the specified mouse 
motion listener so it no longer receives mouse motion 
events from this component. Method addPaintListener 
35 adds the specified paint listener to receive paint 

events from this component. Method removePaintListener 
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removes the specified paint listener so it no longer 
receives paint events from this component. 

Structure Rectangle (Table 20) specifies a 
rectangular area by position and size. Field Y 
5 specifies the y-coordinate . Field Width specifies the 
width. Field Height specifies the height. 

TABLE: 2 0.: STRUCTURE Rectangle 



struct Rectangle 
{ 

long X; 
long Y; 
long Width; 
long Height ; 



10 

An embodiment of interface XWindowListener that is 
used in the above embodiment of interface XWindow 
(Table 19) is presented in Table 21. Interface 
XWindowListener inherits from interface XEventListener 
15 (Table 17) and uses structure WindowEvent (Table 22.) 

TABLE 21.: INTERFACE XWindowListener 



interface XWindowListener: 

com: -.sun: :star: : lang : : XEventListener 

{ 

[oneway] void windowResized ( [in] 

com: : sun : : star : : awt : : WindowEvent e ) ; 

[oneway] void windowMoved ( [in] 

com: : sun: : star :: awt :: WindowEvent e ) ; 
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[oneway] void windowShown ( [in] 

com: : sun: : star: :lang: :EventObject e ) ; 
[oneway] void windowHidden ( [in] 

com: : sun: : star: :lang: : Event Object e ); 

}; 



Interface XWindowListener makes it possible to 
receive window events. Component events are provided 
only for notification purposes. Moves and resizes are 
handled internally by the window component, so that the 
GUI layout works properly independent of whether a 
program registers such a listener. Method windowResized 
is invoked when the window has been resized. Method 
windowMoved is invoked when the window has been moved. 
Method windowShown is invoked when the window has been 
shown. Method windowHidden is invoked when the window 
has been hidden. 

One embodiment of structure WindowEvent used in 
Table 21 is presented in Table 22. 

TABLE 22 . : STRUCTURE WindowEvent 



struct WindowEvent: com: : sun : :Star: :lang: :EventObject 
{ 

long X; 
long Y; 
long Width; 
long Height ; 
long Left Inset; 
long Toplnset; 
long Rightlnset; 
long Bottomlnset ; 

}; 
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Structure WindowEvent specifies the component -level 
keyboard event and inherits from structure EventObject 
(Table 18) . Field X specifies the outer X-position of 
5 the window. Field Y specifies the outer Y-position of 
the window. Field Width specifies the outer (total) 
width of the window. Field Height specifies the outer 
(total) height of the window. Field Left Inset specifies 
the inset from the left. The inset is the distance 

10 between the outer and the inner window, in other words 
in this case it is the width of the left border. Field 
Toplnset specifies the inset from the top. The inset is 
the distance between the outer and the inner window, in 
other words in this case it is the height of the top 

15 border. Field Rightlnset specifies the inset from the 
right. The inset is the distance between the outer and 
the inner window, in other words in this case it is the 
width of the right border. Field Bottomlnset specifies 
the inset from the bottom. The inset is the distance 

2 0 between the outer and the inner window, in other words 
in this case it is the height of the bottom border. 

An embodiment of interface XFocusListener that is 
used in the above embodiment of interface XWindow 
(Table 19) is presented in Table 23. Interface 

25 XFocusListener inherits from interface XEventListener 
(Table 17) and uses structure FocusEvent (Table 24.) 

TABLE 2 3.: INTERFACE XFocusListener 



interface XFocusListener: 

com: :sun: :star: :lang: : XEventListener 

{ 

[oneway] void focusGained( [in] 



Asf iled 

P459S 



com : : sun : : star : : awt : : FocusEvent e ) ; 
[oneway] void f ocusLost ( [in] 

com: : sun: : star: : awt :: FocusEvent e ) ; 

}; 



Interface XFocusListener makes it possible to 
receive keyboard focus events. The window, which has 
the keyboard focus, is the window, which gets the 
5 keyboard events. Method focusGained is invoked when a 
window gains the keyboard focus. Method f ocusLost is 
invoked when a window loses the keyboard focus . 

One embodiment of structure FocusEvent used in 
Table 23 is presented in Table 24. 

.0 

TABLE 24.: STRUCTURE FocusEvent 



struct FocusEvent: com :: sun :: star :: lang :: EventObj ect 
{ 

short FocusFlags; 

com: :sun: :star: :uno: :XInterface Next Focus; 
boolean Temporary; 

}; 



Structure FocusEvent specifies a keyboard focus 
15 event, and inherits from structure EventObj ect 

(Table 18) . There are two levels of focus change 
events: permanent and temporary. Permanent focus change 
events occur when focus is directly moved from one 
component to another, such as through calls to method 
2 0 requestFocus () or as the user uses the Tab key to 

traverse components. Temporary focus change events 
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occur when focus is gained or lost for a component as 
the indirect result of another operation, such as window 
deactivation or a scrollbar drag. In this case, the 
original focus state is automatically restored once that 
5 operation is finished, or for the case of window 

deactivation, when the window is reactivated. Both 
permanent and temporary focus events are delivered using 
the FOCUS_GAINED and FOCUS_LOST event ids; the levels 
may be distinguished in the event using the method 
10 isTemporary () 

Field FocusFlags specifies the reason for the focus 
change as an arithmetic, or combination of 
FocusChangeReason. Field NextFocus contains the window 
which gets the focus on a lose focus event. Field 
15 Temporary specifies if this focus change event is a 
temporary change. 

An embodiment of interface XKeyListener that is 
used in the above embodiment of interface XWindow 
(Table 19) is presented in Table 25. Interface 
2 0 XKeyListener inherits from interface XEventListener 

(Table 17) and uses structure KeyEvent (Table 24.) that 
in turn inherits from structure InputEvent (Table 27) . 

TABLE 2 5.: INTERFACE XKeyListener 



interface XKeyListener: 




com: :sun: :Star: :lang: 


: XEventListener 


{ 

[oneway] void keyPressed( 


[in] 


com: : sun: : star : : awt : : 


KeyEvent e ) ; 


[oneway] void keyReleased( 


[in] 


com : : sun : : Star : : awt : : 

}; 


KeyEvent e ) ; 



Asf lied 
P4596 



Interface XKeyListener makes it possible to receive 
keyboard events. Method keyPressed is invoked when a 
key has been pressed. Method keyReleased is invoked 
when a key has been released. 

The embodiment of structure KeyEvent in Table 2 6 
inherits from structure InputEvent (Table 27) , as 
described above. Structure KeyEvent specifies the 
component -level keyboard event. Field KeyCode contains 
the integer code representing the key of the event. 
This is a constant from the constant group Key. Field 
KeyChar contains the Unicode character generated by this 
event or 0 . Field KeyFunc contains the function type of 
the key event. This is a constant from the constant 
group KeyFunc t ion. 

TABLE 26.: STRUCTURE KeyEvent 



struct KeyEvent: com :: sun :: star :: awt :: InputEvent 
{ 

short KeyCode ; 
char KeyChar; 
short KeyFunc ; 

}; 



Structure InputEvent is the root event class for 
all component -level input events and inherits from 
structure EventObject (Table 18) . Input events are 
delivered to listeners before they are processed 
normally by the source where they originated. Structure 
InputEvent contains the modifier keys, which were 
pressed while the event occurred, i.e., zero or more 
constants from the KeyModifier group. 



TABLE 27. 



STRUCTURE Inpu tEven t 
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struct InputEvent : com: : sun :: star :: lang :: Event Ob j ect 
{ 

short Modifiers; 

}; 



An embodiment of interface XMouseListener that is 
used in the above embodiment of interface XWindow 
5 (Table 19) is presented in Table 28. Interface 

XMouseListener inherits from interface XEventListener 
(Table 17) and uses structure MouseEvent (Table 29.) 
that in turn inherits from structure InputEvent 
(Table 27) . 

.0 

TABLE 2 8.: INTERFACE XMouseListener 



{ 

[oneway] 


void 


mousePressed ( [in] 




com 


: sun 


: star : : awt : : MouseEvent 


e ) ; 


[oneway] 


void 


mouseReleased ( [in] 




com 


: sun 


: star : : awt : : MouseEvent 


e ) ; 


[oneway] 


void 


mouseEntered ( [in] 




com 


: sun 


:star: : awt : : MouseEvent 


e ) ; 


[oneway] 


void 


mouseExited( [in] 




com 

}; 


: sun 


: star : : awt : : MouseEvent 


e ) ; 



Interface XMouseListener makes it possible to 
15 receive events from the mouse in a certain window. 

Method mousePressed is invoked when a mouse button has 
been pressed on a window. Method mouseReleased is 
invoked when a mouse button has been released on a 
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window. Method mouseEntered is invoked when the mouse 
enters a window. Method mouseExited is invoked when the 
mouse exits a window. 

The embodiment of structure MouseEvent in Table 2 9 
5 inherits from structure InputEvent (Table 27) . 

TABLE 2 9.: STRUCTURE MouseEvent 



struct MouseEvent : com: : sun : : star : : awt : : InputEvent 
{ 

short Buttons; 
long X; 
long Y; 

long ClickCount; 
boolean PopupTrigger ; 

}; 



10 Structure MouseEvent specifies an event from the 

mouse. Field Buttons contains the pressed mouse 
buttons, which are zero or more constants from the group 
MouseButton. Field X contains the x coordinate location 
of the mouse. Field Y contains the y coordinate 

15 location of the mouse. Field ClickCount contains the 
number of mouse clicks associated with event. Field 
PopupTrigger specifies if this event is a popup-menu 
trigger event . 

An embodiment of interface XMouseMotionListener 

2 0 that is used in the above embodiment of interface 

XWindow (Table 19) is presented in Table 30. Interface 
XMouseMotionListener inherits from interface 
XEventListener (Table 17) and uses structure MouseEvent 
(Table 29) . 

25 

TABLE 30.: INTERFACE XMouseMotionListener 
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interface XMouseMotionListener : 

com: :sun: :star: :lang: : XEventList ener 

{ 

void mouseDragged ( [in] com: : sun :: star :: awt : :MouseEvent 
e ) ; 

void mouseMoved( [in] com :: sun :: star :: awt : :MouseEvent e 

) ; 

}; 



Interface XMouseMotionListener makes it possible to 
receive mouse motion events on a window. Method 
mouseDragged is invoked when a mouse button is pressed 
on a window and then dragged. Mouse drag events 
continue to be delivered to the window where the first 
event originated until the mouse button is released 
independent of whether the mouse position is within the 
bounds of the window. Method MouseMoved is invoked when 
the mouse button has been moved on a window with no 
but t ons down . 

An embodiment of interface XPaintListener that is 
used in the above embodiment of interface XWindow 
(Table 19) is presented in Table 31. Interface 
XPaintListener inherits from interface XEventListener 
(Table 17) and uses structure PaintEvent (Table 32) that 
inherits from structure EventObject (Table 18) and 
structure Rectangle (Table 20) . See Figure 8B . 

TABLE 31.: INTERFACE XPaintListener 



interface XPaintListener: 

com: :sun: :star: :lang: : XEventListener 

{ 
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[oneway] void windowPaint ( [in] 

com: : sun: : star : : awt : : PaintEvent e ) ; 

}; 



Interface XPaintListener makes it possible to 
receive paint events. Method WindowPaint is called when 
a region of the window becomes invalid, for example, 
because another window was moved away. 

TABLE 32.: STRUCTURE PaintEvent 



struct PaintEvent: com :: sun :: star :: lang :: EventObj ect 
{ 

com: :sun: : star : : awt : : Rectangle UpdateRect ; 
short Count ; 

}; 



Structure PaintEvent specifies the paint event for 
a component. This event is a special type, which is 
used to ensure that paint/update method calls are 
serialized along with the other events delivered from 
the event queue. Field UpdateRect contains the 
rectangle area, which needs to be repainted. Field 
Count contains the number of paint events that follows 
this event if it is a multiple PaintEvent. Paint events 
can be collected until Count is zero. 

An embodiment of interface XFrames Supplier that is 
used in the above embodiment of interface XWindow 
(Table 19) is presented in Table 33. Interface 
XFramesSupplier inherits from interface XFrame 
(Table 15) and uses interface XFrames that in turn 
inherits from several other interfaces as illustrated in 
Figure 8B, and uses several structures, enumerations, 
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and exceptions. One embodiment of each of these 
interfaces, structures, enumeration, and exceptions are 
described herein. 

5 TABLE 3 3.: INTERFACE XFrames Supplier 



interface XFramesSupplier : XFrame 
{ 

XFrames getFrames ( ) ; 
[const] XFrame getActiveFrame () ; 
void setActiveFrame ( [in] XFrame xFrame ); 

}; 



Method getFrames returns the collection of (sub-) 
frames, which is represented by a container 

10 FramesContainer . Method getActiveFrame returns the sub- 
frame, which is active within this frame. This may be 
the frame itself. The active frame is defined as the 
frame, which contains (recursively) the window with the 
focus. If no window within the frame contains the 

15 focus, this method returns the last frame, which had the 
focus. If no containing window ever had the focus, the 
first frame within this frame is returned. 

Method setActive Frame is called on activation of a 
direct sub- frame. This method is allowed to be called 

2 0 only by a sub- frame. After this call, the frame 

specified by input parameter xFrame is returned. In 
general this method first calls the method at the 
creator frame with this as the current argument. Then 
it broadcasts the FrameAct ionEvent 

25 FrameAction: :FRAME_ACTIVATED. 

In the embodiment of Table 34, interface XFrames 
inherits from interface XIndexAccess (Table 35) . 
Interface XFrames manages and creates frames . Frames 
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may contain other frames by implementing an interface 
XFrames and may be contained in other frames . 

TABLE 34 . : INTERFACE XFrames 
5 



interface XFrames: 

com: :sun: :star: : container: : XIndexAccess 

{ 

void append ( 

[in] com: : sun : : star: : frame : :XFrame xFrame ) ; 
sequence<com: :sun: :star: : frame : :XFrame> queryFrames ( 

[in] long nSearchFlags ) ; 
void remove ( [in] com :: sun :: star :: frame :: XFrame xFrame 

) ; 

}; 



Method append appends the specified Frame to a list 
of sub-frames. Method queryFrames returns all child 
frames of the container, which are intended to be 
10 visible to other objects. The content of the sequence 
may be limited by the caller through the flag 
FrameSearchFlag . 

Method remove removes the frame from its container. 
The creator attribute of the frame must be reset by the 
15 caller of this method. 

The embodiment of interface XIndexAccess in 
Table 35 provides access to the elements of a collection 
through an index. This interface should only be used if 
the data structure itself is indexed. 

20 

TABLE 3 5.: INTERFACE XIndexAccess 



interface XIndexAccess : 



-72- 



Asf iled 
P4596 



com: :sun: : star : : container: :XElementAccess 

{ 

[const] long getCount(); 

[const] any getByIndex( [in] long Index ) 
raises ( 

com: :sun: :star: :lang: : IndexOutOf BoundsException, 
com: :sun: :star: :lang: : WrappedTargetExcept ion ) ; 

}; 



Method getCount returns the number of elements. 
Method getBylndex returns the element at the specified 
index. Parameter Index specifies the position in the 
5 array. The first index is 0. Method getBylndex throws 
com: :sun: : star : :lang: : IndexOutOf BoundsException 
(Table 52) if the index is not valid. Method getBylndex 
throws com: : sun : :star: :lang: : WrappedTargetExcept ion 
(Table 49) , if the implementation has internal reasons 
10 for exceptions that are wrapped in exception 
WrappedTargetExcept ion . 

In this embodiment, interface XElementAccess is the 
base interface of all collection interfaces. 

15 TABLE 3 6.: INTERFACE XElementAccess 



interface XElementAccess: 

com: :sun: :star: :uno: :XInterface 

{ 

[const] TYPE_XIDLCLASS getElementType () ; 
[const] boolean hasElement s ( ) ,- 

}; 



Interface XElementAccess inherits from interface 
XInterface (Table 2) . Method getElementType returns the 
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type of the elements. Void means that the container is 
a multi-type container and the exact types with this 
interface cannot be determined with this method. Method 
hasElements returns <TRUE> if the object contain 
elements, otherwise <FALSE>. 

One embodiment of interface XldlClass is presented 
in Table 37. Interface XldlClass provides information 
about a type or module. Every array also belongs to a 
type that is reflected as an XldlClass object that is 
shared by all arrays with the same element type and 
number of dimensions. Finally, any of the primitive IDL 
types are also represented as XldlClass objects. This 
includes "void, any, boolean, char, float, double, 
octet, short, long, hyper, unsigned octet, unsigned 
short, unsigned long" and "unsigned hyper". Interface 
XldlClass inherits from interface XInterface (Table 2) 

TABLE 3 7.: INTERFACE XldlClass 



interface XldlClass: com :: sun :: star :: uno :: XInterface 
{ 

sequence<XIdlClass> getClassesO ; 

XldlClass getClass ( [in] string aName ) ; 

boolean equals ( [in] XldlClass Type ); 

boolean isAssignableFrom ( [in] XldlClass xType ) ; 

com: :sun: :star: :uno: :TypeClass getTypeClass ( ) ; 

string getName ( ) ,- 

[const] com: :sun: : star : :uno: :Uik getUik() ; 
sequence<XIdlClass> getSuperclasses ( ) ; 
sequence<XIdlClass> get Interfaces ( ) ; 
XldlClass getComponentType ( ) ; 
XldlField getField( [in] string aName ) ; 
sequence<XIdlField> getFieldsQ ; 
XldlMethod getMethod ( [in] string aName ) ; 
sequence<XIdlMethod> getMethods ( ) ; 
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XldlArray ge t Array (), • 

void createObj ect ( [out] any obj ) ; 

}; 



Method getClasses returns all types and modules, 
which are declared in this class. Method getClass 
returns a type or module with the given name that is 
5 declared in this class. Method equals returns <TRUE> 
if the instances describe the same type, otherwise 
<FALSE>. Method isAssignableFrom tests if the parameter 
xType is a subclass of this class. Method getTypeClass 
returns the type that this instance represents. Method 

10 getName returns the fully qualified name of the type of 
object (class, interface, array, sequence, struct, 
union, enum or primitive) represented by this XldlClass 
object. Method getUik returns the UIK from this type. 
If the type has no UIK, the returned UIK is zero. 

15 If this object represents an interface or a class, 

the objects that represent the superclasses or 
superinterf aces of that class are returned by method 
getSuperclasses . If this object is the one that 
represents the topmost class or interface, an empty 

2 0 sequence is returned. 

Method get Interfaces determines the interfaces 
implemented by the class or interface represented by 
this object. If the class or interface implements no 
interfaces, the method returns a sequence of length 0. 

25 If this class represents an array or sequence type, 

method Get Component Type returns the XldlClass object 
representing the component type of the array or 
sequence; otherwise it returns null. Method getField 
returns an XldlField object that reflects the specified 

30 member field of the class, interface, struct, union, 

enum or exception represented by this XldlClass object. 
If a field with the specified name is not found, 0 is 
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returned. The field to be reflected is located by- 
searching all the member fields of the class, interface, 
struct, union, enum or exception represented by this 
XldlClass object for a field with the specified name or 
5 for NULL, if a field with the specified name is not 
found. Parameter aNarae specifies the simple name of 
the desired field. 

Method getFields returns a sequence containing 
Field objects reflecting all the accessible fields of 

10 the class, interface, struct, union or enum represented 
by this XldlClass object. Method getFields returns a 
sequence of length 0 if the class or interface has no 
accessible fields, or if it represents an array, a 
sequence or a primitive type. Specifically, if this 

15 XldlClass object represents a class, this method returns 
the fields of this class and of all its superclasses. 
If this XldlClass object represents an interface, the 
method returns the fields of this interface and of all 
its superinterf aces . If this XldlClass object 

20 represents an array, sequence or primitive type, this 
method returns a sequence of length 0 . 

Method getMethod returns an XldlMethod object that 
reflects the specified member method of the interface 
represented by this XldlClass object. If a method with 

25 the specified name is not found, "0" is returned. The 
method to be reflected is located by searching all the 
member methods of the interface represented by this 
XldlClass object for a method with the specified name. 
Parameter aName specifies the simple name of the desired 

3 0 method. 

Method getMethods returns a sequence containing 
XldlMethod objects reflecting all the member methods of 
the class or interface represented by this XldlClass 
object, including those declared by the class or 
35 interface and those inherited from superclasses and 
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super int erf aces . Returns a sequence of length 0 if the 
class or interface has no member methods. 

Method getArray returns interface XldlArray 
(Table 50) to get and set the elements by index if the 
5 represented type is an array or sequence. Method 

createObject creates an instance of the type represented 
by this XldlClass object if the represented type is a 
basic type, struct, enum, or sequence. 

Enumeration TypeClass (Table 38) describe all type 
10 classes, which can be defined in the IDL. 

TABLE 3 8.: Enumeration TypeClass 



enum TypeClass 
{ 

VOID, 

CHAR, 

BOOLEAN, 

BYTE, 

SHORT, 

UNS I GNED_SHORT , 
LONG, 

UNS I GNED_LONG , 
HYPER, 

UNSIGNED_HYPER, 

FLOAT, 

DOUBLE, 

STRING, 

TYPE, 

ANY, 

ENUM, 

TYPEDEF , 

STRUCT , 

UNION, 

ARRAY, 
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INTERFACE , 
SERVICE, 
MODULE , 

INTERFACE_METHOD , 
INTERFACE_ATTRI BUTE , 
UNKNOWN 

}; 



Interface XldlField (Table 39) inherits from 
interface XldlMember (Table 40) . 

5 TABLE 39 .: INTERFACE XldlField 



interface XldlField: 

com: :sun: :star: reflection: :XIdlMember 

{ 

com: :sun: :star: : reflection: :XIdlClass getTypeO ; 
com: :sun: :star: reflection: : FieldAccessMode 

getAccessMode ( ) ; 
any get ( [in] any obj ) 
raises ( 

com: :sun: :star: :lang: : IllegalArgumentException ) ; 
void set ( [in] any obj, [in] any value ) 
raises ( 

com: :sun: :star: :lang: : IllegalArgumentException, 
com: :sun: :star: :lang: : IllegalAccessException ) ; 

}; 



Method getType returns an XldlClass object that 
identifies the declared type for the field represented 
10 by this XldlField object. Method getAccessMode returns 
an enumeration value, which denotes whether the field is 
"const", "readonly", "writeonly" or "readwrite". 
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Method get returns the value of the field 
represented by this field on the specified object. The 
underlying field's value is obtained as follows: 

If the underlying field is a constant, the 
5 object argument is ignored; it may be NULL; 

Otherwise, the underlying field is an instance 
field. 

If the specified object argument is NULL, the method 
throws an " IllegalArgumentException" . If the specified 

10 object is not an instance of the class, interface, 

struct, union or enura declaring the underlying field, 
the method throws an "IllegalArgumentException". 
Otherwise, the value is retrieved from the underlying 
instance or constant . 

15 Method set sets the field represented by this 

XldlField object on the specified object argument to the 
specified new value. The operation proceeds as follows. 
If the specified object argument is NULL, the method 
throws an exception IllegalArgumentException (Table 42) . 

20 If the specified object argument is not an instance of 
the class or interface declaring the underlying field, 
the method throws an exception IllegalArgumentException. 
If the underlying field is constant, the method throws 
an exception IllegalAccessException (Table 43) . If the 

25 new value cannot be converted to the type of underlying 
field by an identity or widening conversion, the method 
throws an IllegalArgumentException. The field is set to 
the possibly widened new value. 

Interface XldlMember (Table 40) inherits from 

30 interface XInterface (Table 2) . Interface XldlMember 
makes it possible to access members of classes 
dynamically. 

TABLE 4 0.: INTERFACE XldlMember 
3 5 

I 
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interface XldlMember: com: : sun : : star : :uno: :XInterface 
{ 

XldlClass getDeclaringClass () ; 
string getName ( ) ; 

}; 



Method getDeclaringClass returns the XldlClass 
object representing the class, interface, struct, union 
or enum that declares the member represented by this 
5 member. Method getName returns the fully qualified name 
of the type (class, interface, array, sequence, struct, 
union, enum or primitive) represented by this XldlClass 
object, as a string. 

The values in enumeration FieldAccessMode 
10 (Table 41) are used to specify the kind of attribute or 
property. 

TABLE 41 .: Enumeration FieldAccessMode 



enum FieldAccessMode 
{ 

// 

/** The property is readable and writeable 
*/ 

READ WRITE , 

// 

/** The property is readonly 
*/ 

READONLY, 

// 

/** The property is write only 
*/ 
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WRITEONLY, 

// 

/** ©deprecated 

*/ 
CONST 

}; 



Exception IllegalArgumentException (Table 42) is 
thrown to indicate that a method has passed an illegal 
or inappropriate argument. Exception 
5 IllegalArgumentException inherits from exception 

Exception (Table 12) . Field Argument Posit ion identifies 
the position of the illegal argument. This field is -1 
if the position is not known. 



10 TABLE 42.: EXCEPTION IllegalArgumentException 



exception IllegalArgumentException : 
com: :sun: :star: :uno: : Exception 

{ 

short Argument Posit ion; 

}; 



Exception IllegalAccessException (Table 43) is 
thrown when an application tries to change a constant 
15 property. Exception IllegalAccessException inherits 
from exception Exception (Table 12) . 



TABLE 43 . : EXCEPTION JllegralAccessException 
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exception IllegalAccessException : 

com: :sun: :star: : uno : : Exception 

{ 

}; 



Interface XldlMethod (Table 44) inherits from 
interface XldlMember (Table 40) . Interface XldlMember 
makes it possible to access the specification of a 
5 method dynamically. 

TABLE 44 . : INTERFACE XldlMethod 



interface XldlMethod: 

com: :sun: :star: reflection: : XldlMember 

{ 

XldlClass getReturnType () ; 
sequence<XIdlClass> getParameterTypes ( ) ; 
sequence<ParamInf o> getParameterlnf os ( ) ; 
sequence<com: :sun: : star : reflection: :XIdlClass> 

getExceptionTypes () ; 
com: :sun: :star: reflection: -.MethodMode getMode ( ) ; 
any invoke ( [in] any obj , [inout] sequence<any> args ) 
raises ( 

com: :sun: :star: :lang: : IllegalArgumentExcept ion, 
com: :sun: :star: reflection: : Invocat ionTargetExcept ion 
) ; 

}; 



10 Method getReturnType returns an XldlClass object 

that represents the formal return type of the method 
represented by this method object. Method 
getParameterTypes returns a sequence of XldlClass 
objects that represent the formal parameter types, in 
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declaration order, of the method represented by this 
Method object. Method getParameterTypes returns a 
sequence of length 0 if the underlying method takes no 
parameters . 

5 Method getParameterlnf os returns a sequence of 

Paramlnfo objects that represent all information about 
the formal parameter types, in declaration order, of the 
method represented by this Method object. Method 
getParameterlnf os returns a sequence of length 0 if the 
10 underlying method takes no parameters. 

Method get Except ionTypes returns a sequence of 
XldlClass objects that represent the types of the 
checked exceptions thrown by the underlying method 
represented by this Method object. Method 
15 get Except ionTypes returns a sequence of length 0 if the 
method throws no checked exceptions. 

Method getMode returns an enumeration value, which 
denotes whether the method is one-way or two-way. 
Method invoke invokes the underlying method represented 
2 0 by this method object on the specified object with the 

specified parameters. Individual parameters are subject 
to widening conversions as necessary. 

Method invocation proceeds in the following order: 
If the specified object argument is NULL, the 
25 invocation throws an IllegalArgumentException; and 

Otherwise, if the specified object argument is 
not an instance of the class or interface declaring 
the underlying method, the invocation throws an 
exception IllegalArgumentException (Table 42) . 
30 If the number of actual parameters supplied via args is 
different from the number of formal parameters required 
by the underlying method, the invocation throws an 
Exception IllegalArgumentException. For each actual 
parameter in the supplied args array, if the parameter 
35 value cannot be converted to the corresponding formal 
parameter type by an identity or widening conversion, 
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the invocation throws exception 

IllegalArgumentException. When the control transfers to 
the underlying method and the method stops abruptly by 
throwing an exception, the exception is placed in an 
5 exception Invocat ionTargetException (Table 48) and 
thrown in turn to the caller of the method. If the 
method completes normally, the value it returns is 
returned to the caller of the method. If the underlying 
method returns type is void, the invocation returns 
10 VOID. 

Structure Paramlnfo (Table 45) describes a formal 
parameter of a method. 

TABLE 4 5.: STRUCTURE Paramlnfo 



struct Paramlnfo 
{ 

/** The name of the parameter. 
*/ 

s t r i ng aName ; 

// 

/** One of the values IN, OUT, INOUT from the PararaMode 
enumeration. 
*/ 

ParamMode aMode ; 

// 

/** The type of the parameter. 
*/ 

XldlClass aType; 

}; 
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The values in Enumeration ParamMode (Table 46) are 
used to specify if a formal parameter of a method is 
used for input, output or both. If the value is an IN 
parameter, data can only transferred from the callee to 
5 the caller. If the value is an OUT parameter, data can 
only transferred from the caller to the callee. If 
value is an INOUT parameter, data can transferred in 
both directions. 

10 TABLE 4 6.: ENUMERATION ParamMode 



enum ParamMode 
{ 

IN, 

OUT, 

INOUT 

}; 



The values in Enumeration MethodMode (Table 47) are 
used to specify the calling mode of a method. If the 
15 value is an ONEWAY parameter, the method call may be 

asynchronous. If the value is a TWOWAY parameter, the 
method call is synchronous. 

TABLE 4 7.: ENUMERATION MethodMode 

2 0 



enum MethodMode 
{ 

ONEWAY , 
TWOWAY 
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Exception InvocationTargetException (Table 48) is a 
checked exception that wraps another exception. 
Typically such exceptions are thrown by an invoked 
method or constructor. Exception 
5 InvocationTargetException inherits from exception 
WrappedTargetException (Table 49) . 

TABLE 48.: EXCEPTION InvocationTargetException 



exception InvocationTargetException: 

com: :sun: :star: :lang: : WrappedTargetException 

{ 

}; 



Exception WrappedTargetException (Table 4 9) is a 
checked exception that wraps an exception thrown by the 
original target. Normally this exception is declared 
for generic methods. Exception WrappedTargetException 
inherits from exception Exception (Table 12) . 

TABLE 4 9.: EXCEPTION WrappedTargetException 



exception WrappedTargetException : 

com: :sun: :star: :uno: : Exception 

{ 

any TargetException; 

}; 




2 0 Interface XldlArray (Table 50) provides methods to 

dynamically access arrays. Interface XTdlArray inherits 
from interface XInterface (Table 2) . 
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TABLE 50.: INTERFACE XldlArray 



interface XldlArray: com: : sun: : star : :uno: :XInt erf ace 
{ 

void realloc( [inout] any array, [in] long length ) 
raises ( 

com: :sun: :star: :lang: : IllegalArgumentException ) ; 
long getLen( [in] any array ) 
raises ( 

com: :sun: : star : : lang : : IllegalArgumentException ) ; 
any get ( [in] any aArray, [in] long nlndex ) 
raises { 

com: :sun: : star : :lang: IllegalArgumentException, 
com: :sun: :star: :lang: : ArraylndexOutOf BoundsExcepti 
on ) ; 

void set { [inout] any aArray, [in] long nlndex, [in] 
any aNewValue ) 
raises ( 

com: :sun: :star: : lang : IllegalArgumentException, 
com: :sun: :star: :lang: : ArraylndexOutOf BoundsExcept ion 
) ; 

}; 



5 Method realloc in interface XldlArray changes the 

size of the array to the new size. If the new length is 
greater, the additional elements are default 
constructed, otherwise the elements are destructed. 
Method realloc throws an exception 
10 IllegalArgumentException (Table 42) if the specified 
object is not an array or if the specified object is 
null . 

Method getLen in interface XldlArray returns the 
number of elements in the array. Method getLen throws 
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an exception IllegalArgumentException (Table 42) if the 
specified object is not an array or if the specified 
object is null. 

Method get in interface XldlArray returns the value 
5 of the indexed component in the specified array object. 
Method get throws exception IllegalArgumentException, if 
the specified object is not an array or if the specified 
object is null. Method get throws exception 
ArraylndexOutOf BoundsException (Table 51) , if the 

10 specified index argument is negative, or if the 

specified index argument is greater than or equal to the 
length of the specified array. 

Method set in interface XldlArray sets the value of 
the indexed component of the specified array object to 

15 the specified new value. Method set throws exception 

IllegalArgumentException, if the specified object is not 
an array or if the specified object is null. Method set 
throws exception ArraylndexOutOf BoundsException 
(Table 51) , if the specified index argument is negative, 

2 0 or if the specified index argument is greater than or 

equal to the length of the specified array. 

Exception ArraylndexOutOf BoundsException (Table 51) 
is thrown to indicate that an array has been accessed 
with an illegal index. The index is either negative or 
25 greater than or equal to the size of the array. 

Exception ArraylndexOutOf BoundsException inherits from 
exception IndexOutOf BoundsException (Table 52) . 

3 0 TABLE 51.: EXCEPTION ArraylndexOutOf BoundsException 



exception ArraylndexOutOf BoundsException : 

com: :sun: :star: :lang: : IndexOutOf BoundsException 

{ 

}; 
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Exception IndexOutOfBoundsException (Table 52) is 
thrown to indicate that a container has been accessed 
with an illegal index. The index is either negative or 
5 greater than or equal to the count of the elements. 
Exception indexOutOfBoundsException inherits from 
exception Exception (Table 12) . 

TABLE 52.: EXCEPTION IndexOutOfBoundsException 
10 

exception IndexOutOfBoundsException : 
com: :sun: :star: :uno: : Exception 

{ 

}; 



As explained above, interface XFrame (Table 15) 
uses interface XController (Table 53) . With interface 
XController, components viewed in a frame can serve 
15 events by supplying dispatches. Interface XController 
inherits from interface XComponent (Table 16) . 

TABLE 53. INTERFACE XController 



interface XController: com: : sun :: star :: lang :: XComponent 
{ 

void attachFrame( [in] XFrame xFrame ); 
boolean attachModel ( [in] XModel xModel ) ; 
boolean suspend ( [in] boolean bSuspend ); 
any getViewData ( ) ; 

void restoreViewData ( [in] any Data ); 
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XModel get Model () ; 
XFrame get Frame () ; 

}; 



Method attachFrame (Table 53) is called to attach 
the controller with its managing frame. Method 
attachModel is called to attach the controller to a new 
5 model. Method suspend is called to prepare the 

controller for closing the view. Method getViewData 
returns data that can be used to restore the current 
view status. Method restoreViewData restores the view 
status using the data gotten from a previous call . 

10 Method getModel returns the currently attached model. 
Method getFrame returns the frame containing this 
controller . 

In Table 54 , interface XModel represents a 
component, which is created from an URL and arguments. 

15 Interface XModel is a representation of a resource in 

the sense that the interface was created/loaded from the 
resource. The arguments are passed to the loader to 
modify its behavior. An example for such an argument is 
"AsTemplate" , which loads the resource as a template for 

20 a new document. Models can be controlled by controller 
components, which are usually views of the model. If 
there is at least one controller, there is by definition 
a current controller, and if that controller supports 
interface XSelectionSupplier , it has a current selection 

2 5 too. Interface XModel inherits from interface 
XComponent (Table 16) . 

TABLE 54 . : INTERFACE XModel 



interface XModel: com: : sun :: star :: lang :: XComponent 
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{ 

boolean attachResource ( [in] string aURL, [in] 

sequence<com: : sun : :star: : beans: : PropertyValue> 
aArgs ) ; 

string getURLO ; 

sequence<com : : sun : :star: : beans: : PropertyValue> 

getArgs ( ) ; 
[oneway] void connectController ( [in] 

com: :sun: :star: : frame: :XController xController ) ; 
[oneway] void disconnectController ( [in] 

com: :sun: :star: : frame : : XController xController ) ; 
[oneway] void lockControllers () ; 
[oneway] void unlockControllers ( ) ; 
boolean hasControllersLocked ( ) ; 
[const] com: :sun: .-star: : frame: : XController 
getCurrentController ( ) ; 
void setCurrentController ( [in] 

com: : sun: : star :: frame :: XController xController ) 
raises ( 

com: :sun: :star: : container: : NoSuchElementExcep 
tion ) ; 

[const] com: :sun: :star: :uno: :XInterface 
getCurrentSelection ( ) ; 

}; 



Method attachResource (Table 54) informs a model 
about its resource description. Method getURL returns 
the URL of the resource, which is represented by this 
5 model . Method getArgs returns the arguments with which 
the model was originally created or stored the last 
time. Method connectController is called whenever a new 
controller is created for this model. Interface 
XComponent of the controller must be used to recognize 
10 when the controller is deleted. Method 
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disconnectController is called whenever a new controller 
is created for this model. Again, interface XComponent 
of the controller must be used to recognize when the 
controller is deleted. 
5 Method lockControllers (Table 54) suspends some 

notifications to the controllers, which are used for 
display updates. The calls to this method may be nested 
and even overlapping, but the calls must be in pairs. 
While there is at least one lock remaining, some 

10 notifications for display updates are not broadcasted. 

Method unlockControllers (Table 54) resumes the 
notifications, which were suspended by call to 
lockControllers. The calls to this method may be nested 
and even overlapping, but they must be in pairs. While 

15 there is at least one lock remaining, some notifications 
for display updates are not broadcasted. 

Method hasControllersLocked (Table 54) determines 
if there is at least one lock remaining. While there is 
at least one lock remaining, some notifications for 

20 display updates are not broadcasted to the controllers. 

Method getCurrentController (Table 54) returns the 
controller, which currently controls this model. If the 
controller, which is active, is a controller of this 
model, it will be returned. If not, the controller, 

2 5 which was the last active controller of this model, is 
returned. If no controller of this model ever was 
active, the controller first registered is returned. If 
no controller is registered for this model, NULL is 
returned. 

30 Method setCurrentController (Table 54) sets a 

registered controller as the current controller. Method 

setCurrentController throws exception 

NoSuchElementException (Table 58) . 

Method getCurrentSelection (Table 54) returns the 
35 current selection in the current controller. If there 

is no current controller, the method returns NULL. 
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Structure PropertyValue (Table 55) specifies a 
property value. Field Name (Table 55) specifies the 
name of the property. The name is unique within a 
sequence of PropertyValues . Field Handle (Table 55) 
5 contains an implementation-specific handle for the 

property. The handle may be -1 if the implementation 
has no handle. If available, the handle it can be used 
for fast lookups . Field Value contains the value of the 
property or void if no value is available. Field State 
10 determines if the value comes from the object itself or 
from a default, and if the value cannot be determined 
exactly 

TABLE 55. : STRUCTURE PropertyValue 

15 



struct PropertyValue 
{ 

string Name; 
long Handle; 
any Value; 

com: :sun: -.star: : beans: : PropertyState State; 

}; 



Enumeration PropertyState (Table 56) lists the 
states that a property value can have . The state 
consists of two aspects: whether a value is available or 
2 0 void; and whether the value is stored in the property 
set itself or is a default or ambiguous. 

Value D I RE CT_VALUE (Table 56) of the property is 
stored in the PropertySet itself. The property value 
must be available and of the specified type. If field 
25 PropertyAttribute in structure Property (Table 57) 
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contains PropertyAttribute : :MAYBEVOID, then the value 
may be void. 

Value DEFAULT_VALUE (Table 56) of the property is 
available from a master (e.g. template). Field 
5 PropertyAttribute in structure Property (Table 57) must 
contain the flag PropertyAttribute : :MAYBEDEFAULT . The 
property value must be available and of the specified 
type. If field PropertyAttribute in the structure 
Property contains PropertyAttribute : :MAYBEVOID, the 

10 value may be void. 

Value AMBIGUOUS_VALUE (Table 56) of the property is 
only a recommendation because there are multiple values 
for this property (e.g. from a multi selection) . Field 
PropertyAttribute in structure Property (Table 57) must 

15 contain flag PropertyAttribute : :MAYBEAMBIGUOUS . The 
property value must be available and of the specified 
type. If field Attribute in structure Property contains 
PropertyAttribute: :MAYBEVOID, n the value may be void. 

20 TABLE 56. : Enumeration Proper tyState 



enum PropertyState 
{ 

D I RECT_VALUE , 
DEFAULT_VALUE , 
AMB I GUOUS__VALUE 

}; 



Structure Property (Table 57) describes a property. 
There are three types of properties: bound properties, 
25 constrained properties and free properties. Field Name 
specifies the name of the property. The name is unique 
within an XPropertySet . Field Handle contains an 
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implementation specific handle for the property. The 
handle may be -1 if the implementation has no handle. 
Field Type contains an object that identifies the 
declared type for the property. If the property has 
5 multiple types or the type is not known, but not any, 
void must be returned. Field Attributes may contain 
zero or more constants of the PropertyAttribute 
constants group. 

10 TABLE 57.: Structure Property 



struct Property 
{ 

string Name; 
long Handle; 
TYPE_XIDLCLASS Type ,- 
short Attributes; 
}; 



Exception NoSuchElementException (Table 58) is 
thrown by the method to indicate that there are no more 
15 elements in the enumeration. Exception 

NoSuchElementException inherits from exception Exception 
(Table 12) . 

TABLE 58 . : EXCEPTION NoSuchElementException 

20 



exception NoSuchElementException: 

com: :sun: :star: :uno: : Exception 

{ 

}; 
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As explained above, interface XFrame (Table 15) 
uses interface XFrameActi onLi stener (Table 59) . 
Interface XFrameActionListener has to be provided if an 
object wants to receive events when several things 
5 happen to components within frames of the desktop, e.g., 
events of instantiation/destruction and 
activation/deactivation of components can be received. 

Interface XFrameActionListener inherits from 
interface XEvent Li stener (Table 17) . Method frameAction 
10 is called whenever any action occurs to a component 
within a frame . 

TABLE 5 9.: INTERFACE XFrameActionListener 



interface XFrameActionListener: 

com: :sun: :star: :lang: : XEvent Li stener 

{ 

[oneway] void frameAction ( [in] 

com: : sun: : star :: frame :: FrameActionEvent aEvent ); 

}; 



15 

Event structure FrameActionEvent (Table 60) is 
broadcast for action, which can happen to components 
within frames. Event structure FrameActionEvent 
inherits from structure EventObject (Table 18) . 
20 In Table 60, field Frame contains the frame in 

which the event occurred. Field Action specifies the 
concrete event . 

TABLE 6 0.: Structure FrameActionEvent 

25 



struct FrameActionEvent: 

com: :sun: :star: :lang: :EventObject 
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{ 

com : : sun : : star : : frame : : XFrame Frame ; 

com: :sun: .-star: .-frame: : FrameAction Action; 

}; 



Enumeration FrameAction (Table 61) specifies the 
events, which can happen to components in frames. An 
event COMPONENT_ATTACHED is broadcast whenever a 
5 component is attached to a frame. This is almost the 
same as the instantiation of the component within that 
frame. The component is attached to the frame 
immediately before this event is broadcast. An event 
COMPONENT_D E TACH I NG is broadcast whenever a component is 

10 detaching from a frame. This is quite the same as the 
destruction of the component, which was in that frame. 
At the moment when the event is broadcast the component 
is still attached to the frame but in the next moment it 
is not attached. An event COMPONENT_REATTACHED is 

15 broadcast whenever a component is attached to a new 

model . In this case the component remains the same but 
operates on a new model component . An event 
FRAME_ACTIVATED is broadcast whenever a component is 
activated. Activations are broadcast from the top 

2 0 component, which was not active before, down to the 

inner most component . An event FRAME_DEACT I VAT ING 
broadcast immediately before the component is 
deactivated. Deactivations are broadcast from the 
innermost component, which does not stay active up to 
25 the outer most component, which does not stay active. 
An event CONTEXT_CHANGED is broadcast whenever a 
component changed its internal context (i.e. the 
selection) . If the activation status within a frame 
changes, this counts as a context change too. An event 

3 0 FRAME__UI_ACTI VATED is broadcast by an active frame when 

the active frame is getting user interface control (tool 
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control) . An event FRAME_UI_DEACTIVATING is broadcast 
by an active frame when the active frame is losing user 
interface control (tool control) . 

5 TABLE 61.: ENUMERATION FrameAction 



enum FrameAction 
{ 

COMPONENT_ATTACHED , 

COMPONENT_DETACHING , 

COMPONENT_REATTACHED , 

FRAME_ACT I VATED , 

F RAME_DE AC T I VAT I NG , 

FRAME_U I _A CT I VATED , 

FRAME_UI_DEACTIVATING 

}; 



As described above, interface XDispatchProvider 
(Table 62 and Fig. 9) is an interface of class BeanFrame 

10 (Fig. 6) . Interface XDispatchProvider provides Dispatch 
interfaces for certain functions, which are useful at 
the user interface. Interface XDispatchProvider 
inherits from interface XInterface (Table 2) , and uses 
interface XDispatch (Table 63) and structures URL 

15 (Table 64) and DispatchDescriptor (Table 67) . 

TABLE 62.: INTERFACE XDispatchProvider 



interface XDispatchProvider: 

com: :sun: :star: : uno : :XInterface 

{ 

com: : sun: : star :: frame :: XDispatch queryDispatch ( [in] 
com : : sun : : star : : util : : URL aURL, 
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[in] string aTargetFrameName, 
[in] long nSearchFlags ) ; 
sequence<com: : sun : :star: : frame: :XDispatch> 
queryDispatches ( [in] 

sequence<com : :sun: :star: : frame : .-DispatchDescriptor 
> aDe scripts ) ; 

}; 



Method queryDispatch (Table 62) searches for an 
XDispatch for the specified URL within the specified 
target frame. Method queryDispatches returns multiple 
5 dispatch interfaces for the specified descriptors at 
once. Actually this method is redundant to method 
DispatchProvider : .-queryDispatch to avoid multiple remote 
calls . 

Interface XDispatch (Table 63) serves state 
10 information of objects, which can be connected to 

controllers (e.g. toolbox controllers). Each state 
change is to be broadcast to all registered status 
listeners. The first notification should be performed 
synchronously, if not, controllers may flicker. State 
15 listener must be aware of this synchronous notification. 
The state includes enabled/disabled and a short 
descriptive text of the function (e.g. "undo insert 
character") . The state is to be broadcast whenever this 
state changes or the controller should reget the value 
2 0 for the URL to which it is connected. Additionally, a 
context-switch-event is to be broadcast whenever the 
object may be out of scope to force the state listener 
to requery the XDispatch. Interface XDispatch inherits 
from interface XInterface (Table 2) . 

25 

TABLE 63.: INTERFACE XDispatch 

I I 
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interface XDispatch: com: : sun: .-star : :uno.- ,-XInterf ace 

{ 

[oneway] void dispatch( [in] com: : sun: : star : :util : :URL 
aURL , [ in] 

sequence<com: :sun: :star: : beans: : PropertyValue> 
aArgs ) ; 

[oneway] void addStatusListener ( [in] 

com: :sun: :star: : frame : :XStatusListener xControl, 
[in] com: : sun: : star : :Util : :URL aURL ) ; 

[oneway] void removeStatusListener ( [in] 

com: :sun: :star: : frame: :XStatusListener xControl, 
[in] com: .-sun: .-star: :util: :URL aURL ) ; 

}; 



Method dispatch (Table 63) dispatches (executes) an 
URL asynchronously. Method dispatch is only allowed to 
dispatch URLs for which the current user gets the 
5 dispatch. Additional arguments "'#..." or "?..." are 
allowed. 

The following is an example for a click-handler of 
a hyperlink in a view. 

XFrame xTarget Frame = m_xFrame- 
10 &gt ; f indFrame (m_aHyperlink- 

&amp ; gt ; getTargetFrameName ( ) , FRAME_S EARCH_S TANDARD 
) ; 

URL aURL; 

aURL. Original = m_aHyperlink-&amp,-gt ;getURL ( ) ; 
15 XDispatch m_xFrame-&gt ; queryDispatch ( 

aURL , sequence&amp ; It ; PropertyValue&amp ; gt ,- ( ) ) ; 

xDi spat ch - &amp ; g t ; di spa t ch ( aURL ) ; 
Method addStatusListener (Table 63) registers a 
listener of a controller for a specific URL to this 
2 0 object to receive status events. This method is only 

allowed to register for URLs for which the current user 
gets this dispatch. Additional arguments "#..." or 
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"?..." are ignored. Method removeStatusListener 
unregisters a listener of a controller. 

Structure URL (Table 64) represents the original 
and the parsed structure of a Uniform Resource Locator. 
5 It is not necessary to set all of the fields; either 
URL :: Complete or (some of) the others are set. 
Additionally, most of the other fields, like URL: -.User, 
URL: : Password or URL::Mark, are optional. 

In Table 64, field Complete contains the unparsed 
10 original URL, for example, 

http : //me :pass@www. stardivision . de : 8080/pub/ test/f oo . txt 
?a=b#xyz . Field Main contains the URL without a mark 
and without arguments, for example. 

http : / /me :pass@www . stardivision . de : 8080/pub/ test/f oo . txt 
15 . Field Protocol contains the protocol (scheme) of the 
URL, for example, "http". Field User contains the user- 
identifier of the URL, for example, "me". Field 
Password contains the users password of the URL, for 
example, "pass". Field Server contains the server part 

2 0 of the URL, for example, "www.stardivision.de". Field 

Port contains the port at the server of the URL, for 
example, "8080". Field Path contains the path part of 
the URL without the filename, for example, "/pub/test". 
Field Name contains the filename part of the URL, for 
25 example, "foo.txt". Field Arguments contains the 

arguments part of the URL, for example, "a=b" . Field 
Mark contains the mark part of the URL, for example 
"xyz" . 

3 0 TABLE 64.: STRUCTURE URL 



struct URL 
{ 

string Complete; 
string Main; 
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string Protocol; 
string User; 
string Password; 
string Server; 
short Port; 
string Path; 
string Name; 
string Arguments; 
string Mark; 



As explained above, interface XSta tusListener 
(Table 65) is used by interface XDispatch (Table 63 and 
Figure 9) . Interface XStatusListener makes it possible 
to receive events when the state of a feature changes. 
Interface XSta tusListener inherits from interface 
XEventListener (Table 17) . Method statusChanged is 
called when the status of the feature changes. 

TABLE 65.: INTERFACE XStatusListener 



interface XStatusListener: 

com: :sun: :star: :lang: : XEventListener 

{ 

[oneway] void statusChanged ( [in] 

com: :sun: : star: : frame: -.FeatureStateEvent Event ); 

}; 



Structure FeatureStateEvent (Table 66) is broadcast 
by a controller, whenever the state of the feature 
15 changes. Structure FeatureStateEvent inherits from 
structure EventObject (Table 18) . 
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In Table 66, field FeatureURL contains the URL of 
the feature. Field FeatureDescriptor contains a 
descriptor of the feature for the user interface. Field 
IsEnabled specifies whether the feature is currently 
5 enabled or disabled. Field Requery specifies whether 
the Dispatch has to be requeried. Field State contains 
the state of the feature in this dispatch. This can be, 
for example, simply TRUE for a Boolean feature like 
underline on/off. Some simple types like string or 
10 Boolean are useful here for generic user interface 
elements, like a checkmark in a menu. 



TABLE 66.: STRUCTURE Features tateEvent 



struct FeatureStateEvent : 




com: : sun: : star : : lang 

{ 


:EventObject 


com: : sun: : star: :util : :URL 


FeatureURL; 


string FeatureDescriptor; 




boolean IsEnabled; 




boolean Requery; 




any State; 

}; 





15 

Structure DispatchDescriptor (Table 67) describes a 
feature to be retrieved by an URL that has to be loaded 
into a specified frame. Field FeatureURL specifies the 
URL of the resource/ function. Field FrameName is the 
2 0 name of the target frame. Field SearchFlags is how the 
target frame is to be searched. 

TABLE 67.: STRUCTURE DispatchDescriptor 

I I 
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struct DispatchDescriptor 
{ 

com: :sun: :star: :util: :URL FeatureURL; 
string FrameName ; 
long SearchFlags ; 

}; 



In the embodiment of Figure 6, the component loaded 
is StarWriter, and class StarWriter includes interface 
XLoadable (Table 68 and Figure 9) . Interface XLoadable 
5 provides functionality to implement objects, which may 
be loaded. Interface XLoadable inherits from interface 
XInterface (Table 2) . 

TABLE 68. : INTERFACE XLoadable 



interface XLoadable: com: : sun :.- star :: uno .- : XInterface 
{ 

[oneway] void load(); 
[oneway] void unload () ; 
[oneway] void reload () ; 
boolean isLoadedO; 

[oneway] void addLoadListener ( [in] 

com: :sun: :star: :form: :XLoadListener aListener ) ; 
[oneway] void removeLoadListener ( [in] 

com: : sun: :star: : form: : XLoadListener aListener ); 

}; 



Method load (Table 68) starts the data processing. 
Method unload stops the data processing. Method reload 
does a smart refresh of the object. The final state is 
15 the same as if unload and load were called, but reload 

is the more efficient way to do the same. If the object 
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isn't loaded, nothing happens. Method isLoaded returns 
true if the object is in loaded state. Method 
addLoadListener adds the specified listener to receive 
events "loaded" and "unloaded." Method 
5 removeLoadListener removes the specified listener. 

Interface XLoadListener (Table 69) is used in the 
load listener method calls in Table 68. Interface 
XLoadListener receives "loaded" and "unloaded" events 
posted by a loadable object. The interface is typically 
10 implemented by data-bound components, which want to 

listen to the data source that contains their database 
form. Interface XLoadListener inherits from interface 
XEventListener (Table 17) . 

15 TABLE 69.: INTERFACE XLoadListener 



interface XLoadListener: 






com 


: sun : : star : : lang 


: : XEventListener 


{ 

[oneway] 


void loaded ( [in 


] 




com. 


: sun : : star : : lang 


: :EventObject 


aEvent ) ,- 


[oneway] 


void unloading ( 


[in] 




com 


: sun : -. star : : lang 


: :EventObject 


aEvent ) ; 


[oneway] 


void unloaded ( [in] 




com: 


:sun: :star: :lang 


: .-EventObject 


aEvent ) ; 


[oneway] 


void reloading ( 


[in] 




com- 


: sun : : star : : lang 


: -.EventObject 


aEvent ) ; 


[oneway] 


void reloaded ( 


[in] 




com: 

}; 


: sun: : star : : lang 


: : EventObject 


aEvent ) ; 



Method loaded (Table 69) is invoked when the object 
has successfully connected to a data source. Method 
2 0 unloading is invoked when the object is about to be 
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unloaded. Components may use this to stop any other 
event processing related to the event source before the 
object is unloaded. Method unloaded is invoked after 
the object has disconnected from a data source. Method 
5 reloading is invoked when the object is about to be 
reloaded. Components may use this to stop any other 
event processing related to the event source until they 
get the reloaded event . Method reloaded is invoked when 
the object has been reloaded. 

10 Class BeanWindow (Fig. 6) includes interfaces 

XWindowPeer (Table 70) and XEventHdl (Table 4) . 
Interface XWindowPeer gives access to the actual window 
implementation on the device. Interface XWindowPeer 
inherits from interface XComponent (Table 16) , and uses 

15 interfaces XToolKit (Table 71) and XPointer (Table 88) , 
which are described below. See also Figures 10A 
and 10B. 

TABLE 7 0.: INTERFACE XWindowPeer 

20 



interface XWindowPeer: com: : sun: :star: :lang: : XComponent 
{ 

XToolkit getToolkit () ; 

[oneway] void setPointer ( [in] XPointer Pointer ) ; 
[oneway] void setBackground ( [in] long Color ) ; 
[oneway] void invalidate ( [in] short Flags ) ; 
[oneway] void invalidateRect ( [in] Rectangle Rect, [in] 
short Flags ) ; 

}; 



Method getToolkit (Table 70) returns the visual 
class, which created this object. Method setPointer 
sets the mouse pointer. Method setBackground sets the 
25 background color. Method invalidate invalidates the 
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whole window using an InvalidateStyle . Method 
invalidateRect invalidates a rectangular area of the 
window using an InvalidateStyle. 

Interface XToolkit (Table 71) specifies a factory 
5 interface for the windowing toolkit. This is similar to 
the abstract window toolkit (AWT) in JAVA. Interface 
XToolkit inherits from interface XInterface (Table 2) . 

TABLE 71.: INTERFACE XToolkit 



interface XToolkit: com: : sun :: star : :uno :: XInterface 
{ 

com: .-sun: .-star: : awt : :XWindowPeer getDesktopWindow ( ) ; 

com: :sun: :star: :awt: .-Rectangle getWorkArea ( ) ; 

com: : sun: : star :: awt : :XWindowPeer createWindow { [in] 

com: : sun: : star: : awt : :WindowDescriptor Descriptor ) 
raises ( 

com: :sun: :star: :lang: : IllegalArgumentException ) ; 
sequence<com: : sun : :star: :awt: : XWindowPeer> 
createWindows ( [in] 

sequence<com: : sun : :star: :awt: : WindowDescriptor> 
Descriptors ) 
raises ( 

com: :sun: :star: : lang : -.IllegalArgumentException ) ; 
com: :sun: :star: : awt : :XDevice 

createScreenCompatibleDevice ( [in] long Width, 
[in] long Height ) ; 
com: :sun: :star: : awt : :XRegion createRegion ( ) ; 
}; 



Method getDesktopWindow (Table 71) returns the 
desktop window. Method getWorkArea returns the complete 
work area for this toolkit. Method createWindow creates 
15 a new window using the given descriptor. Method 
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createWindow throws exception 
IllegalArgumentExcept ion (Table 42) . Method 
createWindows returns a sequence of windows, which are 
newly created using the given descriptors. Method 
5 createWindows throws exception IllegalArgumentException 
Method createScreenCompatibleDevice creates a virtual 
device that is compatible with the screen. Method 
createRegion creates a region. 

Structure WindowDescriptor (Table 72) describes a 
10 window. Field Type specifies the type of window. Field 
WindowServiceNarae specifies the name of the component 
service ("ListBox", " PushButton" ) . A zero length name 
means that the vcl creates a blank top, a container, or 
a simple window. Field Parent specifies the parent of 
15 the component. If the Parent == 0 && Parentlndex == -1, 
the window is on the desktop. Field Parentlndex 
specifies the index of the parent window, if available. 
If Parent == 0 and this structure is a member of an 
array, this is the offset from the beginning of the 
2 0 array to the parent. A value of -1 means desktop. 

Field Bounds specifies the position and size of the 
window. This member is ignored if the window attribute 
is WA_FULLSIZE. Field WindowAt tributes contains some of 
the WA_* attributes . 

25 

TABLE 72 . : STRUCTURE WindowDescriptor 



struct WindowDescriptor 

com: :sun: :star: : awt : :WindowClass Type; 
string Windows erviceName ; 

com: -.sun: :star: : awt : :XWindowPeer Parent; 
short Parentlndex; 

com : : sun : : star : : awt : : Rectangle Bounds ; 
long WindowAttributes ; 

h — 
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] 



Enumeration WindowClass (Table 73) specifies the 
class of a window. Value TOP specifies a top-level 
window on the desktop. It is also a container. Value 
5 MODALTOP is a modal top-level window on the desktop. It 
is also a container. Value CONTAINER is a container 
that may contain other components. It is not a top 
window. Value SIMPLE is the simplest window. It can be 
a container. 

10 

TABLE 73 . : ENUMERATION WindowClass 



enum WindowClass 
{ 

TOP, 

MODALTOP , 

CONTAINER, 

SIMPLE 

}; 



Interface XDevice (Table 74 and Figure 10A) 
15 provides information about a graphical output device and 
offers a factory for the graphics, which provides write 
operations on the device. Interface XDevice inherits 
from interface XInterfa.ce (Table 2) . 

20 TABLE 74.: INTERFACE XDevice 



interface XDevice: com :: sun :: star :: uno : .-Xlnterf ace 

{ 

XGraphics createGraphics ( ) ; 

XDevice createDevice ( [in] long nWidth, [in] long 
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nHeight ) ; 

com: :sun: :star: : awt : :DeviceInfo getlnfoO ; 

sequence<FontDescriptor> getFontDescriptors ( ) ; 

com: : sun: : star :: awt : :XFont getFont { [in] FontDescriptor 

aDescriptor ) ; 
XBitmap createBitmap ( [in] long nX, [in] long nY, 

[in] long nWidth, [in] long nHeight ) ; 
XDisplayBitmap createDisplayBitmap ( [in] XBitmap Bitmap 

) ; 

}; 



Method createGraphics (Table 74) creates a new 
graphics, which output operation direct to this device. 
Method createDevice creates a new device, which is 
5 compatible with this one. If the device does not 
support the GETBITS device capability, this method 
returns NULL. Method get Info returns information about 
the device. Method getFontDescriptors returns the list 
of available font descriptors. 

10 Method getFont (Table 74) returns information about 

a font offered by this device. Parameter aDescriptor 
specifies the description of a font, and specifies that 
the unit of measure is pixel for this device. 

Method createBitmap (Table 74) creates a bitmap 

15 with the current device depth. If the specified area 
does not lie entirely in the device, the bits outside 
are not specified. Method createDisplayBitmap creates a 
device- compatible bitmap. The data of the bitmap is in 
process memory instead of in the device, so the output 

20 operation is fast. 

Interface XGraphics (Table 75) provides the basic 
output operation of a device. Interface XGraphics 
inherits from interface XInterface (Table 2) . 

25 TABLE 75.: INTERFACE XGraphics 
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interface XGraphics: com :: sun :: star :: uno : .-XInterf ace 
{ 

XDevice getDevice ( ) ; 
SimpleFontMetric getFontMetric ( ) ; 

[oneway] void set Font ( [in] XFont xNewFont ) ; 

[oneway] void selectFont ( [in] FontDescriptor 
aDescription ) ; 

[oneway] void setTextColor ( [in] long nColor ) ; 

[oneway] void setTextFillColor ( [in] long nColor ) ; 

[oneway] void setLineColor ( [in] long nColor ),- 

[oneway] void setFillColor ( [in] long nColor ); 

[oneway] void setRasterOp( [in] RasterOperation ROP ); 

[oneway] void setClipRegion ( [in] XRegion Clipping ); 

[oneway] void intersectClipRegion ( [in] XRegion 
xClipping ) ; 

[oneway] void push(); 

[oneway] void pop ( ) ,- 

[oneway] void copy( [in] XDevice xSource, [in] long 
nSourceX, [in] long nSourceY, [in] long 
nSourceWidth, [in] long nSourceHeight , [in] long 
nDestX, [in] long nDestY, [in] long nDestWidth, 
[in] long nDestHeight ) ; 

[oneway] void draw( [in] XDisplayBitmap xBitmapHandle, 
[in] long SourceX, [in] long SourceY, [in] long 
SourceWidth, [in] long SourceHeight , [in] long 
DestX, [in] long DestY, [in] long DestWidth, [in] 
long DestHeight ) ; 

[oneway] void drawPixel ( [in] long X, [in] long Y ) ; 

[oneway] void drawLine ( [in] long XI, [in] long Yl , 
[in] long X2 , [in] long Y2 ) ; 

[oneway] void drawRect ( [in] long X, [in] long Y, [in] 
long Width, [in] long Height ) ; 

[oneway] void drawRoundedRect ( [in] long X, [in] long 
Y, [in] long Width, [in] long Height, [in] long 
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nHorzRound, [in] long nVertRound ) ; 
[oneway] void drawPolyLine ( [in] sequence<long> DataX, 

[in] sequence<long> DataY ) ; 
[oneway] void drawPolygon ( [in] sequence<long> DataX, 

[in] sequence<long> DataY ) ; 
[oneway] void drawPolyPolygon ( [in] sequence< 

sequence<long> > DataX, [in] sequence< 

sequence<long> > DataY ) ; 
[oneway] void drawEllipse{ [in] long X, [in] long Y, 

[in] long Width, [in] long Height ) ; 
[oneway] void drawArc ( [in] long X, [in] long Y, [in] 

long Width, [in] long Height, [in] long XI, [in] 

long Yl, [in] long X2 , [in] long Y2 } ; 
[oneway] void drawPie ( [in] long X, [in] long Y, [in] 

long Width, [in] long Height, [in] long XI, 

[in] long Yl, [in] long X2 , [in] long Y2 ); 
[oneway] void drawChord ( [in] long nX, [in] long nY, 

[in] long nWidth, [in] long nHeight, [in] long 

nXl, [in] long nYl, [in] long nX2 , [in] long nY2 

) ; 

[oneway] void drawGradient ( [in] long nX, [in] long nY, 
[in] long nWidth, [in] long Height, [in] Gradient 
aGradient ) ; 

[oneway] void drawText ( [in] long X, [in] long Y, 

[in] string Text ) ; 
[oneway] void drawTextArray ( [in] long X, [in] long Y, 
[in] string Text, [in] sequence<long> Longs ) ; 



Method getDevice (Table 75) returns the device of 
this graphics. Method getFontMetric returns the font 
metric of the current font. Method setFont sets the 
5 font used by text operations. Method selectFont creates 
a new font and sets the font. Method setTextColor sets 
the text color used by text operations. Method 



-112- 



Asfiled 
P4596 



setTextFillColor sets the fill color used by text 
operations. Method setLineColor sets the line color. 
Method setFillColor sets the fill color. Method 
setRasterOp sets the raster operation. If the device 
5 does not support raster operations, this call is 

ignored. Method setClipRegion sets the clip region to 
specified clipping. Method intersectClipRegion builds 
the intersection with the current region. Method push 
saves all current settings (Font, TextColor, 

10 TextFillColor, LineColor, FillColor, RasterOp, 

ClipRegion) . Method pop restores all previous saved 
settings. Method copy copies a rectangle of pixels from 
another device into this one. Method draw draws a part 
of the specified bitmap to the output device. Method 

15 drawPixel sets a single pixel in the output device. 
Method drawLine draws a line in the output device. 
Method drawRect draws a rectangle in the output device. 
Method drawRoundedRect draws a rectangle with rounded 
corners in the output device. Method drawPolyLine draws 

20 multiple lines in the output device at once. Method 

drawPolygon draws a polygon line in the output device. 
Method drawPolyPolygon draws multiple polygons in the 
output device at once. Method drawEllipse draws an 
ellipse in the output device. Method drawArc draws an 

25 arc (part of a circle) in the output device. Method 
drawPie draws a circular area in the output device. 
Method drawChord draws a chord of a circular area in the 
output device. A chord is a segment of a circle. You 
get two chords from a circle if you intersect the circle 

30 with a straight line joining two points on the circle. 
Method drawGradient draws a color dispersion in the 
output device . Method drawText draws text in the output 
device . Method drawTextArray draws texts in the output 
device using an explicit kerning table. 

35 Structure SimpleFontMetric (Table 76) describes the 

general metrics of a font. Field Ascent specifies the 
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portion of a lower case character that rises above the 
height of the character "x" of the font. For example, 
the letters 'b', 'd', 'h', 'k' and '1' have an ascent 
unequal to 0. Ascent is measured in pixels, thus the 
5 font metric is device dependent. Field Descent 

specifies the portion of a letter falling below the 
baseline. For example, the letters 'g', 'p', and 'y' 
have a descent unequal to 0 . Descent is measured in 
pixels, thus the font metric is device dependent. Field 

10 Leading specifies the vertical space between lines of 
this font, and is also called internal line spacing. 
The leading is measured in pixels, thus the font metric 
is device dependent. Field Slant specifies the slant of 
the characters (italic) . The slant is measured in 

15 degrees from 0 to 359. Field FirstChar specifies the 
code of the first printable character in the font . 
Field LastChar specifies the code of the last printable 
character in the font . 

2 0 TABLE 76.: STRUCTURE SimpleFontMetric 



struct SimpleFontMetric 
{ 

short Ascent ; 
short Descent; 
short Leading; 
char FirstChar; 
char LastChar; 

}; 



Interface XFont (Table 77) describes a font on a 
specific device. All values are in pixels within this 
25 device. Interface XFont inherits from interface 
XInterface (Table 2) . 
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TABLE 77.: INTERFACE XFont 



interface XFont: com: : sun: : star : :uno : :XInt erf ace 
{ 

com: :sun: :star: :awt: : FontDescriptor 

getFontDescriptor ( ) ; 
com: :sun: :star: :awt: : SimpleFontMetric getFontMetric ( ) ; 
short getCharWidth ( [in] char c ) ; 

sequence<short> getCharWidths ( [in] char nFirst, [in] 

char nLast ) ; 
long getStringWidth ( [in] string str ); 
long getStringWidthArray ( [in] string str, [out] 

sequence <long> aDXArray ) ; 
void getKernPairs ( [out] sequence<char> Charsl, [out] 

sequence <char> Chars2 , [out] sequence<short> Kerns 

) ; 

}; 



5 Method getFontDescriptors (Table 77) returns the 

description of the font. Method getFontMetric returns 
additional information about the font. Method 
getCharWidth returns the width of the specified 
character measured in pixels for the device. Method 

10 getCharWidths returns a sequence of the widths of 
subsequent characters for this font . Method 
getStringWidth returns the width of the specified string 
of characters measured in pixels for the device. Method 
getStringWidthArray returns the width of the specified 

15 string of characters measured in pixels for the device. 
In this method, parameter aDXArray receives the width of 
every single character measured in pixels for the 
device. Method getKernPairs queries the kerning pair 
table. 
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Structure FontDescriptor (Table 78) describes the 
characteristics of a font. For example, this structure 
can be used to select a font. Field Name specifies the 
exact name of the font ("Arial", "Courier", "Frutiger") . 
5 Field Height specifies the height of the font in the 
measure of the destination. Field Width specifies the 
width of the font in the measure of the destination. 
Field StyleName specifies the style name of the font 
("Bold", "Fett", "Italic Bold"). Field Family specifies 

10 the general style of the font. Use one value out of the 
constant group FontFamily. Field CharSet specifies the 
character set, which is supported by the font. Use one 
value out of the constant group CharSet. Field Pitch 
specifies the pitch of the font. Use one value out of 

15 the constant group FontPitch. Field CharacterWidth 
specifies the character width. Depending on the 
specified width, a font that supports this width may be 
selected. The value is expressed as a percentage. 
Field Weight specifies the thickness of the line. 

2 0 Depending on the specified weight, a font that supports 
this thickness may be selected. The value is expressed 
as a percentage. Field Slant specifies if there is a 
character slant (italic) . Field Underline uses one 
value out of the constant group FontUnderline . Field 

2 5 Strikeout uses one value out of the constant group 

FontStrikeout . Field Orientation specifies the rotation 
of the font. The unit of measure is degrees; 0 is the 
baseline. Field Kerning, for requesting, it specifies 
if there is a kerning table available: for selecting, it 

30 specifies if the kerning table is to be used. Field 

WordLineMode specifies if only words get underlined. A 
value of TRUE means that only non- space characters get 
underlined while a value of FALSE means that the spacing 
also gets underlined. This property is only valid if 

35 the property FontDescriptor :: Underline is not 
FontUnderline .- .-NONE . Field Type specifies the 
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technology of the font representation. One or more 
values out of the constant group FontType can be 
combined by an arithmetical or-operat ion . 

TABLE 78.: STRUCTURE FontDescriptor 



struct FontDescriptor 
{ 

string Name; 

short Height; 

short Width; 

string StyleName; 

short Family; 

short CharSet; 

short Pitch; 

float CharacterWidth; 

float Weight; 

com: :sun: :star: : awt : : Font Slant Slant; 

short Underline; 

short Strikeout; 

float Orientation; 

boolean Kerning; 

boolean WordLineMode ; 

short Type; 

}; 



Enumeration FontSlant (Table 79) is used to specify 
the slant of a font. Value NONE specifies a font 

10 without slant. Value OBLIQUE specifies an oblique font 
(slant not designed into the font) . Value ITALIC 
specifies an italic font (slant designed into the font) . 
Value DONTKNOW specifies a font with an unknown slant. 
Value REVERSE_OBLIQUE specifies a reverse oblique font 

15 (slant not designed into the font) . Value 
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REVERSE ITALIC specifies a reverse italic font (slant 
designed into the font) . 

TABLE 79.: ENUMERATION FontSlant 



enum FontSlant 
{ 

NONE, 

OBLIQUE, 

ITALIC, 

DONTKNOW, 

REVERSE_OBLIQUE , 

REVERSE_ITALIC 

}; 



The values in enumeration RasterOperation 
(Table 80) are used to specify the binary pixel - 
operation applied when pixels are written to the device. 
Value OVERPAINT sets all pixels as written in the output 
operation. Value XOR uses the pixel written as one and 
the current pixel as the other operator of an exclusive 
or-operation. Value ZEROBITS causes all bits, which are 
affected by this operation, to be set to 0. Value 
ALLBITS causes all bits, which are affected by this 
operation, to be set to 1. Value INVERT causes all 
bits, which are affected by this operation, to be 
inverted . 

TABLE 80.: ENUMERATION RasterOperation 



enum RasterOperation 
{ 

OVERPAINT, 
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XOR, 

ZEROBITS, 

ALLBITS, 

INVERT 

}; 



Interface XRegion (Table 81 and Figures 10A 
and 10B) manages multiple rectangles, which make up a 
region. Interface XRegion inherits from interface 
5 Xlnterfa.ce (Table 2) . 



INTERFACE XRegion 



interface XRegion: com: : sun :: star :: uno : :XInterf ace 
{ 

Rectangle getBounds ( ) ; 
[oneway] void clear (); 

[oneway] void move ( [in] long nHorzMove, [in] long 
nVertMove ) ; 

[oneway] void unionRec tangle ( [in] Rectangle Rect ) ; 
[oneway] void intersectRectangle ( [in] Rectangle Region 
) ; 

[oneway] void excludeRectangle ( [in] Rectangle Rect ) ; 
[oneway] void xOrRectangle ( [in] Rectangle Rect ) ; 
[oneway] void unionRegion ( [in] XRegion Region ) ; 
[oneway] void intersectRegion ( [in] XRegion Region ); 
[oneway] void excludeRegion ( [in] XRegion Region ) ; 
[oneway] void xOrRegion( [in] XRegion Region ) ; 
sequence<Rectangle> getRectangles ( ) ; 



Method getBounds (Table 81) returns the bounding 
box of the shape. Method clear makes this region an 
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empty region. Method move moves this region by the 
specified horizontal and vertical delta. Method 
unionRectangle adds the specified rectangle to this 
region. Method intersectRectangle intersects the 
5 specified rectangle with the current region. Method 
excludeRectangle removes the area of the specified 
rectangle from this region. Method xOrRect angle applies 
an exclusive-or operation with the specified rectangle 
to this region. Method unionRegion adds the specified 

10 region to this region. Method intersectRegion 

intersects the specified region with the current region. 
Method excludeRegion removes the area of the specified 
region from this region. Method xOrRegion applies an 
exclusive-or operation with the specified region to this 

15 region. Method getRectangles returns all rectangles, 
which are making up this region. 

Interface XDisplayBitmap (Table 82) specifies an 
object as a bitmap for which data is formatted for a 
specific output device. Drawing of this bitmap is only 

20 valid on a compatible device. Interface XDisplayBitmap 
inherits from interface XInterface (Table 2) . 

TABLE 82.: INTERFACE XDisplayBitmap 



interface XDisplayBitmap: 

com: :sun: :star: :uno: : XInterface 

{ 

}; 



25 

Structure Gradient (Table 83) describes a color 
dispersion within an area. Field Style specifies the 
style of the gradient. Field StartColor specifies the 
color at the start point of the gradient. Field 
30 EndColor specifies the color at the end point of the 
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gradient. Field Angle specifies the angle of the 
gradient in 1/10 degree. Field Border specifies the 
percent of the total width where just the start color is 
used. Field XOffset specifies the X-coordinate , where 
gradient begins. Field YOffset specifies the Y- 
coordinate, where gradient begins. Field Startlntensity 
specifies the intensity at the start point of the 
gradient. Field Endlntensity specifies the intensity at 
the end point of the gradient . Field StepCount 
specifies the number of steps of change color. 

TABLE 83.: STRUCTURE Gradient 



struct Gradient 
{ 

com: :sun: :star: :awt: : Gradient Style Style; 

long StartColor; 

long EndColor; 

short Angle; 

short Border; 

short XOffset; 

short YOffset; 

short Startlntensity; 

short Endlntensity ; 

short StepCount; 

}; 



Enumeration GradientStyle (Table 84) specifies the 
style of color dispersion. Value LINEAR specifies a 
linear gradient. Value AXIAL specifies an axial 
gradient. Value RADIAL specifies a radial gradient. 
Value ELLIPTICAL specifies an elliptical gradient. 
Value SQUARE specifies a gradient in the shape of a 
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square. Value RECT specifies a gradient in the shape of 
a rectangle. 

TABLE 84.: ENUMERAT I ON Gra dientS tyl e 

5 



enura GradientStyle 
{ 

LINEAR, 

AXIAL, 

RADIAL, 

ELLIPTICAL, 

SQUARE, 

RECT 

}; 



Structure Devicelnfo (Table 85) contains 
information about a device. Field Width contains the 
width of the device in pixels. Field Height contains 

10 the height of the device in pixels. Field Leftlnset 
contains the inset from the left. Field Toplnset 
contains the inset from the top. Field Rightlnset 
contains the inset from the right . Field Bottomlnset 
contains the inset from the bottom. Field 

15 PixelPerMeterX contains the X-axis resolution of the 
device in pixel/meter. Field PixelPerMeterY contains 
the Y-axis resolution of the device in pixel/meter. 
Field BitsPerPixel contains the color-depth of the 
device. Field Capabilities specifies special 

2 0 operations, which are possible on the device. 

TABLE 8 5.: STRUCTURE Devicelnfo 



struct Devicelnfo 
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{ 

long Width; 
long Height ; 
long Leftlnset; 
long Toplnset ; 
long Rightlnset; 
long Bottomlnset; 
double PixelPerMeterX; 
double PixelPerMeterY; 
short BitsPerPixel ; 
long Capabilities; 

}; 



Interface XBitmap (Table 86) provides a bitmap in 
the Microsoft DIB format. Interface XBitmap inherits 
from interface XInterface (Table 2) . Method getSize 
5 returns the size of the bitmap in pixels. Method getDIB 
returns the device independent bitmap. Method 
getMaskDIB returns the transparence mask of the device 
independent bitmap . 

10 TABLE 86.: INTERFACE XBitmap 



interface XBitmap: com: : sun :: star :: uno :: XInterface 
{ 

com: :sun: :star: :awt: :Size getSizeO ; 
sequence<byte> getDIBO; 
sequence <byte> getMaskDIB () ; 

}; 



Structure Size (Table 87) specifies the two- 
dimensional size of an area using width and height. 
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Field Width specifies the width. Field Height specifies 
the height . 

TABLE 8 7.: STRUCTURE Size 



struct Size 
{ 

long Width; 
long Height; 

}; 



Interface XPointer (Table 88) gives access to the 
type of mouse pointer. Interface XPointer inherits from 
interface XInterface (Table 2) . Method setType selects 
10 a SystemPointer for this mouse pointer. Method getType 
returns the currently set SystemPointer of this mouse 
pointer. 

TABLE 8 8.: INTERFACE XPointer 



interface XPointer: com: : sun: : star : :uno :: XInterface 
{ 

[oneway] void setType ( [in] long nType ) ; 
long getType () ; 

}; 



Table 89 is one embodiment of a remote virtual 
device interface XRmVirtualDevice that is included in 
one embodiment of lightweight component 230. 

20 

TABLE 89.: INTERFACE XRmVirtualDevice 
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interface XRmVirtualDevice : 

com: :sun: :star: :uno: :XInterface 

{ 

[oneway] void Create ( [in] unsigned long nCompDev, 

[in] long nWidth, [in] long nHeight, [in] unsigned 

short nBitCount ) ; 
[oneway] void SetOutputSizePixel ( [in] long nWidth, 

[in] long nHeight ) ; 
[oneway] void ResizeOutputSizePixel ( [in] long nWidth, 

[in] long nHeight ) ; 

}; 



Table 90 is one embodiment of interfaces XRmBitmap 
and XRmJavaBitmap that are included in one embodiment of 
5 lightweight component 230. These interfaces are used 
when a runtime environment component on server computer 
system needs to display a bitmap on user device 102i. 

TABLE 9 0.: INTERFACES XRmBitmap and XRmJavaBitmap 



interface XRmBitmap : com :: sun :: star :: uno :: XInt erf ace 
{ 

/** 

InitiateTransf er : initialize bitmap to empty with 
width, height and depth the next parameters 
determine the format of the scanlines transported 
by subsequent Transfer calls: palette for palette 
bitmaps, the palette entries are in the order 
blue (or index), green, red, bool . the bool tells 
whether the first byte is an index or not. 
(implementation detail: this is a vcl BitmapColor) 
format and scanlinesize determine how to interpret 
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the scanlines transported in each Transfer call, 
compressiontype marks the compression algorithm 
used on the byte sequences in Transfer call with 0 
meaning uncompressed. InitiateTransf er with width 
and height set to 0 is legal, the bitmap data 
should be purged then. 

*/ 

[oneway] void InitiateTransf er ( [in] long width, 

[in] long height, [in] long depth, [in] sequence< 
byte > palette, [in] long format, [in] long 
scanlinesize, [in] long compressiontype ) ; 

J ** 

* Transfer: transports one or more scanlines of the 
bitmap initialized in InitiateTransf er . 

*/ 

[oneway] void Transfer ( [in] ByteSequence aData ); 
unsigned long QueryBitmapPtr ( ) ; 

[oneway] void Draw ( [in] long nDestX, [in] long 
nDestY, [in] long nDestWidth, [in] long 
nDestHeight, [in] long nSrcX, [in] long nSrcY, 

[in] long nSrcWidth, [in] long nSrcHeight, [in] 
XRmOut put Device xOutputDevice ) ; 
[oneway] void DrawEx ( [in] long nDestX, [in] long 
nDestY, [in] long nDestWidth, [in] long 
nDestHeight, [in] long nSrcX, [in] long nSrcY, 

[in] long nSrcWidth, [in] long nSrcHeight, [in] 
XRmBitmap xBitmap, [in] XRmBitmap xBitmapMask, 

[in] XRmOutputDevice xOutputDevice, [in] boolean 
bAlpha ) ; 

[oneway] void DrawMask ( [in] long nDestX, [in] long 
nDestY, [in] long nDestWidth, [in] long 
nDestHeight, [in] long nSrcX, [in] long nSrcY, 
[in] long nSrcWidth, [in] long nSrcHeight, [in] 
XRmBitmap xBitmap, [in] unsigned long nColor, [in] 
XRmOutputDevice xOutputDevice ) ; 

[oneway] void CreateBitmap ( [in] long nX, [in] long 
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nY, [in] long nWidth, [in] long nHeight, [in] 
XRmOutput Device xOutputDevice ) ; 
void GetBitmap( [out] ByteSequence rData ); 

}; 

interface XRmJavaBitmap : XRmBitmap 
{ 

[oneway] void Set ImageData ( [in] long nBit Count, [in] 
long nWidth, [in] long nHeight, [in] ByteSequence 
aColorMap, [in] ByteSequence alndexData, [in] 
LongSequence aRGBData) ; 
void Get ImageData ( [out] long rBitCount, [out] long 
rWidth, [out] long rHeight, [out] ByteSequence 
rColorMap, [out] ByteSequence rBitmapData, [out] 
LongSequence rRGBData, [out] long rAlphaMask, 
[out] long rRedMask, [out] long rGreenMask, [out] 
long rBlueMask) ; 

}; 



Table 91 is one embodiment of interfaces 
XRmPrintObserver, XRmPrinterEnvironment , XRmPr inter , and 
XRmPrintSpooler that are included in one embodiment of 
5 lightweight component 230. These interfaces are used 
when a runtime environment component on server computer 
system needs to print to a printer coupled to user 
device 102i. 

10 TABLE 91.: INTERFACES XRmPrintObserver, 

XRmPrinterEnvironment , XRmPr inter , and XRmPrintSpooler 

{ 

II [in] Eingabe -Parameter . Der "Server" auf dem das 
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Object liegt ist der Remote -Client . 
// Also "Server" eigentlich "Display" 
// [oneway] => Kein warten auf Antwort 
typedef sequence< byte, 1 > RmJobSetup; 
typedef sequence< byte, 1 > RmQueuelnfo; 
typedef sequence< byte, 1 > RmPrinterPage; 
typedef sequence< string, 1 > StringSequence; 

interface XRmPrinterObserver : 

com: :sun: :Star: : uno : :XInterface 

{ 

[oneway] void PrinterSettingsChanged ( ) ; 

}; 

interface XRmPrinterEnvironment : 

com: :sun: :star: :uno: :XInterface 

{ 

unsigned short GetQueueCount ( ) ; 

void GetQueuelnf o ( [in] unsigned short nQueue, [out] 

RmQueuelnfo rRmQueuelnfo ) ; 
boolean GetPrinterlnf o ( [in] string sPrinterName , 

[out] RmQueuelnfo rRmQueuelnfo ) ; 
void GetPrinterNames ( [out] StringSequence 

rPrinterNames ) ; 
stringGetDef aultPrinterName ( ) ; 

void SetObserver ( [in] XRmPrinterObserver rObserver ) ; 

}; 

interface XRmPrinter : com: : sun :: star :: uno :: XInterf ace 
{ 

void Create ( [in] RmQueuelnfo aRmQueuelnf o, [out] 

RmJobSetup rRmJobSetup ) ; 
boolean Set JobSetup ( [inout] RmJobSetup rRmJobSetup ) ; 
boolean SetOrientation ( [in] unsigned short 

nOrientation, [inout] RmJobSetup rRmJobSetup ) ; 
boolean SetPaperBin ( [in] unsigned short nPaperBin, 

[inout] RmJobSetup rRmJobSetup ) ; 
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boolean SetPaper ( [in] unsigned short nPaper, [inout] 

RmJobSetup rRmJobSetup ) ; 
boolean SetPaperSizeUser ( [in] long nWidth, [in] long 

nHeight, [inout] RmJobSetup rRmJobSetup ) ; 
void GetPageInfo{ [out] long rOutWidth, [out] long 

rOutHeight, [out] long rPageOffX, [out] long 

rPageOffY, [out] long rPageWidth, [out] long 

rPageHeight ) ; 
unsigned short GetPaperBinCount ( ) ; 
string GetPaperBinName ( [in] unsigned short 

nPaperBin ) ; 

/** query the printer for its capabilities (mainly to 
decide whether it is possible to bring up a 
printer setup dialogue) 

*/ 

unsigned long GetCapabilit ies ( [in] unsigned short 
nType ) ; 

/** brings up a UI to setup the current jobsetup. 

Returns the modified (and still current ) jobsetup 
if successful. If not successful (e.g. user 
cancel) the return is empty. Mote: return is 
delivered as a UserEvent on the EventListener of 
xParent 

*/ 

[oneway] void UserSetup ( [in] XRmFrameWindow xParent , 
[in] unsigned long Event ID ) ,- 

}; 

interface XRmSpoolLauncher : 

com: :sun: :star: :uno: :XInterface 

{ 

boolean LaunchSpooler ( [in] string sUserName, [in] 
string sPassword ) ; 

}; 

interface XRmPrintSpooler : 

com: :sun: :star: : uno : :XInterface 

{ 
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void Create ( [in] RmJobSetup jobSetup ); 
boolean Start Job ( [in] unsigned short nCopies, [in] 
boolean bCollate, [in] string aJobName, [in] 
string sFileName , [in] boolean bPrintFile) ; 
[oneway] void SpoolPage ( [in] RmPrinterPage page ); 
void AbortJobO ; 
void End Job ( ) ; 

}; 
}; 

Table 92 is one embodiment of interface 
XRmFil eSt ream. Table 93 is one embodiment of interface 
XRmFSys. Both of these interfaces are included in one 
5 embodiment of lightweight component 230. These 

interfaces are used when a runtime environment component 
reads or writes data on a storage medium of user device 
102i, or needs to obtain information about data stored 
on a storage medium of user device 102i. In this 

10 embodiment, object BeanService 532 receives, as 

described above, a handle to object ClientFactory 515. 
The handle to object ClientFactory 515 to instantiate an 
object on the user device to access a particular 
capability on the user device, e.g., the file system, 

15 printing, sound, etc. 

TABLE 92 . : INTERFACE XRmFileStream 



{ 

typedef sequence< byte, 1 > RFSByteSequence ; 
interface XRmFileStream : 

com: :sun: :star: :uno: :XInterface 
{ // interface 
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// param aFilename : file to open 

// param nOpenMode : file mode read 

// param blsOpen: file opend successfully 

// param blsWritable: file opend writable 

// param nStreamMode : stream mode 

/ / param nError : Error Code 

// returns fileHandle: handle 

unsigned long open ( [in] string aFilename, 

[in] unsigned short nOpenMode, [out] boolean 
blsOpen, [out] boolean blsWritable, [out] 
unsigned short nStreamMode, [out ] unsigned long 
nError) ; 

// param handle: filehandle 

void close () ; 

// param aData: data read from stream 
// param nSize: number of bytes to read 
// param nError: errorcode 

// returns: number of bytes that were successfully read 
unsigned long getData ( [out ] RFSByteSequence aData, 

[in] unsigned long nSize, [out] unsigned long 

nError) ; 

// param nData: data to write to stream 

// param nSize: number of bytes to write 

// param nError: errorcode 

// returns: number of bytes that were successfully 
// written 

unsigned long putData([in] RFSByteSequence aData, [in] 
unsigned long nSize, [out] unsigned long nError) ; 
// param nPos : desired position 
/ / param nError : errorcode 
// returns: new position 

unsigned long seekPos([in] unsigned long nPos, [out] 

unsigned long nError) ; 
// param nSize: new filesize 
/ / param nError : errorcode 
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Void setSize ( [in] unsigned long nSize, [out] unsigned 

long nError) ; 
// param nByteOf f set : where to start locking 
// param nBytes: how many bytes to lock 
// param nError: errorcode 
// returns: success 

boolean lockRange ( [in] unsigned long nByteOffset, [in] 
unsigned long nBytes, [out] unsigned long nError) ; 
// param nByteOffset: where to start unlocking 
// param nBytes: how many bytes to unlock 
// param nError: errorcode 
// returns: success 

boolean unlockRange ( [in] unsigned long nByteOffset, 
[in] unsigned long nBytes, [out] unsigned 
longnError) ; 

} ; } ; 



TABLE 93 . : INTERFACE XRmFSys 



{ 

struct FileStatMembers 



{ 



unsigned 


long 


nError ; 


unsigned 


long 


nKindFlags ; 


unsigned 


long 


nSize; 


string 




aCreator ; 


string 




aType ; 


unsigned 


long 


aDateCreated; 


unsigned 


long 


aTimeCreated; 


unsigned 


long 


aDateModif ied; 


unsigned 


long 


aTimeModified; 


unsigned 


long 


aDateAccessed; 


unsigned 


long 


aTimeAccessed; 
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}; 

typedef sequence< string, 1 > DirEntrySequen.ee; 
typedef sequence< FileStatMembers , 1 > 

FileStat Sequence ; 
typedef sequence< unsigned long, 1 > FSysSortSequence ; 

interface XRmFSys : com: :sun: :star: :uno: :XInterface 
{ // interface 

boolean isCaseSensitive ( [in] string aDirEntry) ; 
string tempName { [in] string aDirEntry, [in] unsigned 
long eKind) ; 

boolean toAbs { [in] string aDirEntry, [out] string 
aResult) ; 

boolean toRel ( [in] string aDirEntry, [out] string 
aResult) ; 

boolean toRelRel ( [in] string aDirEntry, [in] string 

aRelative, [out] string aResult) ; 
boolean makeShortName ( [inout] string aDirEntry, [in] 

string aLongName, [in] unsigned long nCreateKind, 

[in] boolean bUseTilde, [in] unsigned long 

nStyle) ; 

unsigned short scan ( [in] string aDirEntry, [out] 

DirEntrySequence aDirEntryList , [out] 

FileStatSequence aFileStatList , [in] 

FSysSortSequence aSortLst , [in] string aNameMask, 
[in] unsigned short nAttrMask, [in] boolean 

bFillFileStatList) ; 
boolean update ( [out] FileStatMembers aFileStat, [in] 

string aDirEntry, [in] boolean 

bAccessRemovableDevice) ; 
unsigned long queryDiskSpace ( [in] string aPath, [out] 

unsigned long nFreeBytes, [out] unsigned long 

nTotalBytes) ; 
string getDevice ( [in] string aDirEntry) ; 
string getVolume ( [in] string aDirEntry) ,- 
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unsigned long getPathStyle ( [in] string aDevice) ; 
boolean hasReadOnlyFlag ( ) ; 

boolean getReadOnlyFlag ( [in] string aDirEntry) ; 
boolean exists ( [in] string aDir, [in] unsigned long 
nAccess) ; 

boolean first ( [inout] string aDir) ; 

boolean find ( [in] string aDirEntry, [in] string 

aPfad, [in] char cDelim, [out] string aResult) ; 
boolean setCWD ( [in] string aDir, [in] boolean 

bS loppy) ; 

boolean makeDir ( [in] string aDir, [in] boolean 
bS loppy) ; 

long setReadOnlyFlag ( [in] string aDirEntry, [in] 
boolean bRO) ; 

void setDateTime ( [in] string aFileName, [in] unsigned 
long nDate, [in] unsigned long nTime) ; 

unsigned long moveTo ( [in] string aFromDir, [in] 
string aToDir) ; 

unsigned long kill ( [in] string aFromDir, [in] unsigned 
long nActions) ; 

}; 

}; 



Table 94 is one embodiment of interfaces 
XSoundCa.llBa.ck and XRMSound that are included in one 
embodiment of lightweight component 23 0. These 
interfaces are used when a runtime environment component 
needs to play sounds on user device 102i. 

TABLE 94 . : INTERFACES XSoundCallBack and XRMSound 



{ 

II 



- SoundSequence - 
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typedef sequence< byte, 1 > SoundSequence; 
// - SoundCallback 



interface XSoundCallback : 

com: :sun: :star: :uno: :XInterface 

{ 

[oneway] void Notify ( [in] unsigned short 

nNotif ication, [in] unsigned long nError ) ; 

}; 

// - XRmSound - 

interface XRmSound : com: : sun :: star :: uno :: XInt erf ace 
{ 

[oneway] void Create ( [in] XSoundCallback 

XSoundCallback ) ; 
unsigned long Transfer ( [in] unsigned long nExtraData, 

[in] SoundSequence aData, [in] string aFileName ) ; 
[oneway] void SetStartTime ( [in] unsigned long 

nStartTime ) ; 

[oneway] void SetPlayTime ( [in] unsigned long nPlayTime 
) ; 

[oneway] void SetLoopMode ( [in] boolean bLoop ) ; 
[oneway] void ClearError () ; 
[oneway] void PlayO ; 
[oneway] void StopO; 
[oneway] void Pause (); 

}; 



Table 95 is one embodiment of interface XRmStatus 
that is included in one embodiment of lightweight 
component 230. This interfaces is used when a runtime 
5 environment component needs the status of user device 
102i . 



-135- 



Asfiled 
P4596 



TABLE 95.: INTERFACES XRmStatus 



interface XRmStatus : com: : sun :: star : :uno : :XInterf ace 
{ 

unsigned long GetRemoteVersion ( ) ; 
unsigned long GetSystemType { ) ; 
unsigned long GetSystemCharSet ( ) ; 

void ShowError ( [in] string aMsg, [in] unsigned short 
nCode ) ; 

void ShowWarning ( [in] string aMsg, [in] unsigned short 
nCode ) ; 

void Showlnf o ( [in] string aMsg, [in] unsigned short 

nCode ) ; 
void Quit ( ) ; 

}; 
}; 



Those skilled in the art will readily understand 
5 that the operations and actions described herein 

represent actions performed by a CPU of a computer in 
accordance with computer instructions provided by a 
computer program. Therefore, lightweight component 23 0 
may be implemented by a computer program causing the CPU 

10 of the computer to carry out instructions representing 
the individual operations or actions as described 
hereinbefore. The computer instructions can also be 
stored on a computer- readable medium, or they can be 
embodied in any computer-readable medium such as any 

15 communications link, like a transmission link to a LAN, 
a link to the internet, or the like. 

Thus, lightweight component 23 0 can be implemented 
by a computer program comprising computer program code 
or application code. This application code or computer 

2 0 program code may be embodied in any form of a computer 



-136- 



Asf iled 
P4596 



program product. A computer program product comprises a 
medium configured to store or transport this computer- 
readable code, or in which this computer-readable code 
may be embedded. Some examples of computer program 
5 products are CD-ROM discs, ROM cards, floppy discs, 
magnetic tapes, computer hard drives, servers on a 
network, and carrier waves. The computer program 
product may also comprise signals, which do not use 
carrier waves, such as digital signals transmitted over 

10 a network (including the Internet) without the use of a 
carrier wave . 

The storage medium including the 
applications/services executed on a server may belong to 
server computer system 100 itself. However, the storage 

15 medium also may be removed from server computer 
system 100. The only requirement is that the 
applications/services are accessible by server computer 
system 100 so that the application/service corresponding 
to lightweight component 23 0 can be executed by 

20 server 100. 

Herein, a computer memory refers to a volatile 
memory, a non-volatile memory, or a combination of the 
two in any one of these devices. Similarly, a computer 
input unit and a display unit refer to the features 

25 providing the required functionality to input the 
information described herein, and to display the 
information described herein, respectively, in any one 
of the aforementioned or equivalent devices. 

While the present invention has been explained in 

3 0 connection with certain embodiments thereof, other 

embodiments will be apparent to those skilled in the art 
from consideration of the specification and practice of 
the embodiment of the present invention disclosed 
therein. It is intended that the specification and 

35 examples be considered as exemplary only, without 
limiting the spirit and scope of the invention. 
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